HERE Map Content Developer's Guide

Relationship Type

Definition

Relationship Type identifies the type of relationship that exists between two Places involved in a relationship.

Values

String

Usage

Relationship Type allows retrieval of information when the Place is located within, or serves another Place, such as a hotel near an airport.

Specification

  • Relationship Type is applied as follows:
    • IDENTITY is applied when the relationship pertains to the identity of a Place that belongs. For example, an old church may also be a historical monument.

    • LOCATION is applied when the relationship pertains to the location of a Place. For example, a petrol station may also contain a convenience store.
    • PHYSICAL is applied when the related Places are located at the same place or are directly attached to each other.

      Examples:

      Places within the boundary of the main Place, such as a Restaurant in a Shopping Centre or a Convenience Store in a Gasoline Station.

    • LOGICAL is applied when Parent-Child relationship is logical or conceptual (vs. physical). The Places are not physically located at the same place, or not directly attached to each other.

      Example: An open parking area that is located outside of any of the terminal buildings at an airport.

    • EXCLUSIVE is applied for a dedicated relationship between Places. For example, a parking facility that is meant for use only by visitors to Place.
    • PRIVATE is applied for an access-control relationship between Places. For example, a hotel may have a private garage which can only be accessed with a key-card by guests staying in the hotel.
    • PREFERRED is applied for a formal service agreement between Places. For example, a public parking garage may offer free parking to patrons of a nearby theater with a validated ticket.
    • SUGGESTED is applied for relationship being a suggested relationship between Places. For example, a parking facility near a sports complex may be the closest place to park with the lowest rate.
  • The same Place can be involved in multiple relationships if it is according to reality. For example, a restaurant can be involved in a Location and Exclusive Relationship with a hotel.

  • Relationship Type values are generally applied to specific Relationship Names are described below:
    Relationship Type Relationship Name
    IDENTITY Association
    LOCATION Association
    PHYSICAL Parent-Child, Parent, and Child
    LOGICAL Parent-Child, Parent, and Child