Location and point of interest

The product feed offers a number of ways for you to specify points of interest associated with the product. Google will use this information to help surface the product to users when relevant POI or destinations are being searched.

Each product option can specify one or more points of interests(POIs) related to the option via the related_location field (containing a list of RelatedLocation objects). Each RelatedLocation object contains a location describing the POI in question and a relation_type describing the relationship between the POI and the product option.

A product option should only be marked as related if it provides a meaningful experience of the location in addition to physically visiting it. The definition of "meaningful” might vary for different locations, but things that usually should not be marked as related include views of a POI via e.g. a boat cruise or bus tour or meeting points for tours (use the meeting_point field instead). The three relation_types are:

  • RELATED_NO_ADMISSION: Location is related but the product option does not include admission or admission is irrelevant, e.g. the location is a square highlighted in a city tour.

  • ADMISSION_TICKET: Relation grants admission to this related location.

  • SUPPLEMENTARY_ADDON: Relation declares an additional service which doesn't get the user into the related location, e.g. a parking ticket, a temporary exhibition, etc.

Examples

relation_type Example
RELATED_NO_ADMISSION Walking tour around the Eiffel tower without entry. Helicopter tour around the Burj Khalifa.
ADMISSION_TICKET Entry ticket to a Zoo, can include additional addons.
SUPPLEMENTARY_ADDON Skip the line without entry, audio guide without entry.
Not related Boat cruise which sees the POI from a distance. Tour office where the tour starts or ticket can be purchased.

Each product option may also have a meeting_point for specific tour types where the starting location is unclear and must be determined (e.g. guided tours).

In general, location in the feed spec can be represented in one of three ways (in order of preference):

  1. Google place ID: This is the preferred method of passing location information as it has the highest degree of accuracy. To get the google place id from street addresses, you can use the Places API (Similar to string based addresses below, Places API search results improve when the POI name is added as part of the search string).

  2. String based address: This is the next preferred option as we can use this signal to determine the correct POI with high degree of accuracy. This is less accurate than place ids as a matching heuristic will be used to determine the POI. The address should contain the name of the POI first followed by a comma and the street address. For example: Madame Tussauds London, Marylebone Rd, London NW1 5LR, United Kingdom.

  3. Latitude & longitude: This is the least preferred option as a point using latitude and longitude can represent many things e.g. city, country. If provided , we will only use this information to determine the city or general location.