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
.
Related locations and relation_type
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).
How to pass location for a related POI to Google
In general, location in the feed spec can be represented in one of three ways (in order of preference):
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).
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
.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.