POI-Feeds erstellen und hochladen
Beachten Sie beim Erstellen und Hochladen von POI-Feeds die folgenden Hinweise:
- Halten Sie sich bei POI-Datendateien an die Spezifikation, die im POI-Feed beschrieben ist. Wir empfehlen, für jeden Upload eindeutige Dateinamen für POI-Daten zu verwenden. Fügen Sie dem Dateinamen einen Zeitstempel hinzu, z. B.
POI_1633621547.json. - Laden Sie Feeds täglich als vollständige Aktualisierungen auf den lokalen SFTP-Server für POIs hoch.
- Details zum SFTP-Server findest du im Partner-Portal unter Konfiguration > Feeds.
- Den Status der Feedaufnahme finden Sie im Partner-Portal unter Aufnahme > Verlauf.
Feedspezifikationen
Anforderungen an Felder
VssPoi
Stellt eine einzelne POI-Entität (Point of Interest) dar, z.B. ein Hotel oder Restaurant.
| Feldname | Typ | Anforderung | Beschreibung |
|---|---|---|---|
poi_id | String | Erforderlich | Erforderlich. Ein vom Partner generierter String, der einen POI identifiziert. |
name | object(Text) | Erforderlich | Erforderlich. Der Name des POI. |
telephone | String | Die Kontakttelefonnummer des POI, einschließlich der Landesvorwahl und Vorwahl, z. B. +14567891234 | |
url | String | Die URL der öffentlichen Website des POI. Hinweis: Diese Informationen werden nur für den Abgleich verwendet, nicht für die Anzeige. | |
location | object(GeoCoordinates) | Erforderlich | Erforderlich. Der Standort des POI. |
display_address | object(Text) | Die in der Benutzeroberfläche angezeigte Adresse. | |
images | Array von Objekt(Image) | Bilder des POI. Maximale Anzahl von Bildern: 5. | |
rating | Zahl | Durchschnittliche Bewertung für den POI. | |
num_ratings | Zahl | Die Anzahl der Bewertungen, die zum Feld rating beigetragen haben. | |
rating_scale | Zahl | Die für das Feld rating verwendete Bewertungsskala. Wenn die maximale Bewertung 5 ist, ist rating_scale 5. | |
category | enum(Category) | Erforderlich | Erforderlich. Stellt die Kategorie des POI dar. |
description | object(Text) | Eine Beschreibung des POI. | |
| oneOf(additional_data) | Erforderlich | Es kann nur eines der Felder in diesem „oneOf“ festgelegt werden. |
Text
Stellt einen Text mit Lokalisierungen dar.
| Feldname | Typ | Anforderung | Beschreibung |
|---|---|---|---|
localizations | Array von Objekt(LocalizedString) | Die lokalisierten Strings. | |
default_locale | String | Die als Standardsprache zu verwendende Sprache muss in den Lokalisierungen vorhanden sein. |
LocalizedString
Stellt einen lokalisierten String dar.
| Feldname | Typ | Anforderung | Beschreibung |
|---|---|---|---|
locale | String | Das Sprach-Tag des Texts, z. B. „en“, „en-US“ oder „sr-Latn“. | |
text | String | Der Text in der angegebenen Sprache. |
GeoCoordinates
Die geografischen Daten eines Standorts, einschließlich Breitengrad, Längengrad und Adresse
| Feldname | Typ | Anforderung | Beschreibung |
|---|---|---|---|
latitude | Zahl | [-90, +90] Grad (einschließlich). Erforderlich, wenn der Längengrad festgelegt ist, ansonsten optional. | |
longitude | Zahl | [-180, +180] Grad (einschließlich). Erforderlich, wenn der Breitengrad festgelegt ist, ansonsten optional. | |
| oneOf(addresses) | Erforderlich | Es kann nur eines der Felder in diesem „oneOf“ festgelegt werden. |
PostalAddress
Die Postanschrift des Standorts.
| Feldname | Typ | Anforderung | Beschreibung |
|---|---|---|---|
country | String | Erforderlich | Erforderlich. Das Land anhand des ISO 3166-1 Alpha-2-Ländercodes, z.B. „US“. |
locality | String | Erforderlich | Erforderlich. Der Ort/die Stadt, z.B. „Mountain View“. |
region | String | Die Region/das Bundesland/der Kanton, z.B. „CA“. Dieses Feld ist nur in Ländern erforderlich, in denen die Region normalerweise Teil der Adresse ist. (optional) | |
postal_code | String | Erforderlich | Erforderlich. Die Postleitzahl, z. B. "94043" |
street_address | String | Erforderlich | Erforderlich. Die Adresse, z. B. "1600 Amphitheatre Pkwy" |
Bild
Stellt ein Bild des POI dar.
| Feldname | Typ | Anforderung | Beschreibung |
|---|---|---|---|
url | String | Die URL des Bildes. Google crawlt die Fotos, die unter dieser URL gehostet werden. Maximale Länge: 2.000 Zeichen. | |
alt_text | object(Text) | Der alternative Text, der für die Barrierefreiheit verwendet werden soll. |
HotelData
Hotelspezifische Feeddaten.
| Feldname | Typ | Anforderung | Beschreibung |
|---|---|---|---|
hotel_star_class | Zahl | Die offizielle Sternebewertung der Hotelkategorie. Kann in einem Label wie „5-Sterne-Hotel“ verwendet werden. Dieser Wert muss eine Ganzzahl zwischen 1 und 5 sein. | |
brand_ids | String-Array | Die Marken, unter denen dieses Hotel angezeigt werden kann. Wenn dieses Feld leer ist, kann das Hotel unter jeder der mit dem Feed verknüpften Marken angezeigt werden. |
LocalData
Einrichtungsspezifische Feeddaten.
| Feldname | Typ | Anforderung | Beschreibung |
|---|---|---|---|
business_hours | object(BusinessHours) | Die regulären Öffnungszeiten des Betriebs. | |
price_range | object(PriceRange) | Preisspanne der vom Unternehmen angebotenen Dienstleistungen. | |
establishment_category | object(Text) | Die Art des Betriebs. | |
brand_landing_pages | Array von Objekt(BrandLandingPages) | Die Marken-Landingpages. |
BusinessHours
Die Zeiträume, für die dieser Standort geöffnet ist Enthält eine Sammlung von [TimeRange][madden.vss_poi_feed.TimeRange]-Instanzen. Beispiel: Samstags von 9:00 bis 12:00 Uhr und von 13:00 bis 17:00 Uhr geöffnet: time_ranges { open_day: SATURDAY open_time: { hours: 9, minutes: 0 } close_day: SATURDAY close_time: { hours: 12, minutes: 0 } } time_rages { open_day: SATURDAY open_time: { hours: 13, minutes: 0 } close_day: SATURDAY close_time: { hours: 17, minutes: 0 } } Beispiel: Samstags von 21:00 Uhr bis Sonntag 2:00 Uhr geöffnet: time_ranges { open_day: SATURDAY open_time: { hours: 21, minutes: 0 } close_day: SUNDAY close_time: { hours: 2, minutes: 0 } }
| Feldname | Typ | Anforderung | Beschreibung |
|---|---|---|---|
time_ranges | Array von Objekt(TimeRange) | Eine Sammlung von Uhrzeiten, aus der die Öffnungszeiten dieses POI hervorgehen. Jeder Zeitraum steht für eine Anzahl von Stunden, in denen der POI in der Woche geöffnet ist. |
TimeRange
Stellt eine Zeitspanne dar, in der der POI geöffnet ist. Sie beginnt zur Startzeit am angegebenen Tag und endet zur Endzeit am angegebenen Tag. Das Ende muss nach dem Beginn liegen, beispielsweise am selben Tag oder an einem anderen Tag.
| Feldname | Typ | Anforderung | Beschreibung |
|---|---|---|---|
open_day | enum(DayOfWeek) | Der erste Tag des Zeitraums. | |
open_time | object(TimeOfDay) | Die Öffnungszeit des Zeitraums. | |
close_day | enum(DayOfWeek) | Der letzte Tag des Zeitraums. | |
close_time | object(TimeOfDay) | Die Endzeit des Zeitraums. |
TimeOfDay
| Feldname | Typ | Anforderung | Beschreibung |
|---|---|---|---|
hours | Zahl | Stunden eines Tages im 24-Stunden-Format. Muss größer oder gleich 0 und in der Regel kleiner oder gleich 23 sein. Eine API kann den Wert „24:00:00“ für Szenarien wie Geschäftsschlusszeit zulassen. | |
minutes | Zahl | Minuten einer Stunde. Muss größer oder gleich 0 und kleiner oder gleich 59 sein. | |
seconds | Zahl | Sekunden einer Minute. Muss größer oder gleich 0 und in der Regel kleiner oder gleich 59 sein. Eine API kann den Wert 60 zulassen, wenn sie Schaltsekunden zulässt. | |
nanos | Zahl | Sekundenbruchteile in Nanosekunden. Muss größer oder gleich 0 und kleiner oder gleich 999.999.999 sein. |
PriceRange
Preisspanne der vom POI angebotenen Dienste.
| Feldname | Typ | Anforderung | Beschreibung |
|---|---|---|---|
min_price | object(Money) | Der Mindestpreis der vom POI angebotenen Dienste. | |
max_price | object(Money) | Der Höchstpreis der vom POI angebotenen Dienstleistungen. |
Geld
Stellt einen Geldbetrag mit Währungstyp dar
| Feldname | Typ | Anforderung | Beschreibung |
|---|---|---|---|
currency_code | String | Der aus drei Buchstaben bestehende Währungscode gemäß ISO 4217 | |
units | Zahl | Die ganzen Einheiten des Betrags.
Beispiel: Wenn currencyCode "USD" ist, dann entspricht eine Einheit 1 US-Dollar. | |
nanos | Zahl | Anzahl der Nanoeinheiten (10^-9) des Betrags.
Der Wert muss im Bereich von -999.999.999 bis +999.999.999 liegen.
Wenn units positiv ist, muss nanos positiv oder null sein.
Wenn units null ist, kann nanos positiv, null oder negativ sein.
Wenn units negativ ist, muss nanos negativ oder null sein.
-1,75 $ wird z. B. als units = −1 und nanos = −750.000.000 dargestellt. |
BrandLandingPages
Die lokalisierten Marken-Landingpages für einen einzelnen POI.
| Feldname | Typ | Anforderung | Beschreibung |
|---|---|---|---|
brand_id | String | Die Marke, für die diese Konfiguration gilt. | |
localized_landing_pages | Array von Objekt(LocalizedLandingPage) | Die lokalisierten Landingpages. Die Werte der Felder „url“ und „locales“ müssen für alle lokalisierten Zielseiten eindeutig sein. | |
default_url | String | Die Standard-Landingpage-URL, die verwendet werden soll, wenn keine der lokalisierten Landingpages mit der Sprache des Nutzers übereinstimmt. |
LocalizedLandingPage
Lokalisierte Landingpage für den POI.
| Feldname | Typ | Anforderung | Beschreibung |
|---|---|---|---|
url | String | Die URL der Landingpage. Maximale Länge: 2.000 Zeichen. | |
locales | String-Array | Beschränkt diese Seite auf Nutzer mit der angegebenen Spracheinstellung. Muss Sprach-Tags wie „en“, „en-US“ oder „sr-Latn“ enthalten. |
Kategorie
Stellt die Kategorie des POI dar.
Er sollte mit dem unten stehenden „oneof“-Feld additional_data übereinstimmen.
| Name | Beschreibung |
|---|---|
UNKNOWN_CATEGORY | |
HOTEL | |
LOCAL |
DayOfWeek
Steht für einen Wochentag.
| Name | Beschreibung |
|---|---|
DAY_OF_WEEK_UNSPECIFIED | Der Wochentag ist nicht angegeben. |
MONDAY | Montag |
TUESDAY | Dienstag |
WEDNESDAY | Mittwoch |
THURSDAY | Donnerstag |
FRIDAY | Freitag |
SATURDAY | Samstag |
SUNDAY | Sonntag |
additional_data
Erforderlich. Kategoriespezifische Felder.
Er sollte mit dem Feld category oben übereinstimmen.
| Feldname | Typ | Anforderung | Beschreibung |
|---|---|---|---|
hotel_data | object(HotelData) | Schließt sich mit | Hotelspezifische Felder. |
local_data | object(LocalData) | Schließt sich mit | Lokalspezifische Felder. |
Adressen
Erforderlich. Adresse für einen Standort.
| Feldname | Typ | Anforderung | Beschreibung |
|---|---|---|---|
address | object(PostalAddress) | Postanschrift des Standorts. |
- Format: Muss JPEG, PNG oder WebP sein.
- Maximale Dateigröße: Unter 30 MB pro Bild.
- Maximale Abmessungen: Weniger als 75 Megapixel insgesamt (Breite × Höhe < 75.000.000).
- URL-Typ: Direkter Pfad zum Bild-Asset (z.B. endet mit „.jpg“).
- Berechtigungen: Der Hostserver muss den Zugriff auf Googlebot oder Crawler zulassen und darf keine robots.txt-Datei haben, die die Bildverzeichnisse blockiert.
Definitionen
VssPoiFeed – Definition
// Represents a Point of Interest (POI) data feed provided by a partner. export message VssPoiFeed { // The POIs in the feed. repeated VssPoi data = 1; }
VssPoi – Definition
// Represents a single Point of Interest (POI) entity e.g. a hotel or // restaurant. export message VssPoi { // Required. A string generated by the partner that identifies a POI. string poi_id = 1; // The entity name, telephone, url and location are used to support // matching partner inventory with entities already present on Google. // Required. The name of the POI. Text name = 2; // The contact telephone number of the POI including its country and // area codes, e.g. +14567891234. string telephone = 3 [(datapol.semantic_type) = ST_PHONE_NUMBER]; // The url of the POI's public website. // Note: This will be used just for matching purposes, not for display. string url = 4; // Required. The location of the POI. GeoCoordinates location = 5; // The address displayed on the UI. Text display_address = 17; // Images of the POI. // Max number of images: 5. repeated Image images = 6; // Average rating for the POI. float rating = 12; // The number of contributing ratings for the `rating` field. int64 num_ratings = 13; // The rating scale used for the `rating` field. If max rating is 5, then // rating_scale is 5. int32 rating_scale = 14; // Represents the category of the POI. // It should match the `additional_data` oneof field below. export enum Category { LOCAL = 4; } // Required. Represents the category of the POI. Category category = 9; // A description of the POI. Text description = 16; // Required. Category specific fields. // It should match the `category` field above. oneof additional_data { // Local specific fields. LocalData local_data = 15; } }
Text – Definition
// Represents a text with localizations. message Text { // Represents a localized string. message LocalizedString { // The text's language tag, such as "en", "en-US" or "sr-Latn". string locale = 1; // The text in the specified locale. string text = 2; } // The localized strings. repeated LocalizedString localizations = 1; // The locale to use as the default language it must be present in the // localizations. string default_locale = 2; }
GeoCoordinates – Definition
// The Geo data of a location, including latitude, longitude, and address. message GeoCoordinates { option (datapol.msg_semantic_type) = ST_LOCATION; // [-90, +90] degrees (inclusive). // Required if longitude is set, otherwise nice to have. double latitude = 1; // [-180, +180] degrees (inclusive). // Required if latitude is set, otherwise nice to have. double longitude = 2; // Required. Address for a location. oneof addresses { // Postal address of the location. PostalAddress address = 3; } }
PostalAddress – Definition
// The postal address for the location. message PostalAddress { option (datapol.msg_semantic_type) = ST_LOCATION; // Required. The country, using ISO 3166-1 alpha-2 country code, e.g. "US". string country = 1; // Required. The locality/city, e.g. "Mountain View". string locality = 2; // The region/state/province, e.g. "CA". This field is only required in // countries where region is commonly a part of the address. (optional) string region = 3; // Required. The postal code, e.g. "94043". string postal_code = 4; // Required. The street address, e.g. "1600 Amphitheatre Pkwy". string street_address = 5; }
Bilddefinition
// Represents an image of the Point of Interest (POI). export message Image { // The url of the image. Google will crawl the media hosted at this URL. // Max length: 2000. string url = 1; // The alternative text to be used for accessibility. Text alt_text = 2; }
LocalData – Definition
// Establishment specific feed data. message LocalData { // The regular business hours of the establishment. BusinessHours business_hours = 1; // Price range of the services offered by the establishment. PriceRange price_range = 2; // The type of establishment. Text establishment_category = 3; // The brand landing pages. repeated BrandLandingPages brand_landing_pages = 4; }
BrandLandingPages – Definition
// The Localized brand landing pages for a single Point of Interest (POI). message BrandLandingPages { // The brand this configuration applies to. string brand_id = 1 [(datapol.semantic_type) = ST_PARTNER_ID]; // Localized landing page for the Point of Interest (POI). message LocalizedLandingPage { // The url of the landing page. // Max length: 2000. string url = 1; // Restricts this page to users with the specified language preference. // Must contain language tags, such as "en", "en-US" or "sr-Latn". repeated string locales = 3; } // The localized landing pages. // The url and locales fields values must be unique across all the localized // landing pages. repeated LocalizedLandingPage localized_landing_pages = 2; // The default landing page url to be used when none of the localized // landing pages matches the user's language. string default_url = 3; }
Beispiele
POI-Feed
Dateiname: poi_1707240000.json
{ "data": [ { "poi_id": "test_restaurant_1", "name": { "localizations": [ { "locale": "en", "text": "Tasty Bites Test Restaurant" } ], "default_locale": "en" }, "telephone": "+1234567890", "url": "https://www.tastybitestest.com", "location": { "latitude": 37.422, "longitude": -122.084, "address": { "country": "US", "locality": "Mountain View", "postal_code": "94043", "street_address": "1600 Amphitheatre Pkwy" } }, "display_address": { "localizations": [ { "locale": "en", "text": "1600 Amphitheatre Pkwy, Mountain View, CA 94043" } ], "default_locale": "en" }, "images": [ { "url": "https://www.tastybitestest.com/images/interior.jpg", "alt_text": { "localizations": [ { "locale": "en", "text": "Cozy dining area of Tasty Bites" } ], "default_locale": "en" } } ], "rating": 4.7, "num_ratings": 150, "rating_scale": 5, "category": "LOCAL", "description": { "localizations": [ { "locale": "en", "text": "A mock restaurant for testing the POI feed ingestion." } ], "default_locale": "en" }, "local_data": { "establishment_category": { "localizations": [ { "locale": "en", "text": "Restaurant" } ], "default_locale": "en" }, "price_range": { "min_price": { "currency_code": "USD", "units": 15, "nanos": 0 }, "max_price": { "currency_code": "USD", "units": 45, "nanos": 0 } }, "business_hours": { "time_ranges": [ { "open_day": "MONDAY", "open_time": { "hours": 11, "minutes": 0 }, "close_day": "MONDAY", "close_time": { "hours": 21, "minutes": 0 } }, { "open_day": "TUESDAY", "open_time": { "hours": 11, "minutes": 0 }, "close_day": "TUESDAY", "close_time": { "hours": 21, "minutes": 0 } }, { "open_day": "WEDNESDAY", "open_time": { "hours": 11, "minutes": 0 }, "close_day": "WEDNESDAY", "close_time": { "hours": 21, "minutes": 0 } }, { "open_day": "THURSDAY", "open_time": { "hours": 11, "minutes": 0 }, "close_day": "THURSDAY", "close_time": { "hours": 22, "minutes": 0 } }, { "open_day": "FRIDAY", "open_time": { "hours": 11, "minutes": 0 }, "close_day": "FRIDAY", "close_time": { "hours": 23, "minutes": 0 } }, { "open_day": "SATURDAY", "open_time": { "hours": 10, "minutes": 0 }, "close_day": "SATURDAY", "close_time": { "hours": 23, "minutes": 0 } }, { "open_day": "SUNDAY", "open_time": { "hours": 10, "minutes": 0 }, "close_day": "SUNDAY", "close_time": { "hours": 20, "minutes": 0 } } ] }, "brand_landing_pages": [ { "brand_id": "tasty_bites_brand", "localized_landing_pages": [ { "url": "https://www.tastybitestest.com/en", "locales": ["en-US", "en-GB"] } ], "default_url": "https://www.tastybitestest.com" }, { "brand_id": "delicious_eats_brand", "localized_landing_pages": [ { "url": "https://www.deliciouseats.com/en", "locales": ["en-US", "en-GB"] } ], "default_url": "https://www.deliciouseats.com" } ] } } ] }
Mehrsprachiger POI-Feed
Dateiname: poi_multilingual.json
{ "data": [ { "poi_id": "test_restaurant_1", "name": { "localizations": [ { "locale": "en", "text": "Tasty Bites Test Restaurant" }, { "locale": "fr", "text": "Restaurant de test Tasty Bites" } ], "default_locale": "en" }, "telephone": "+1234567890", "url": "https://www.tastybitestest.com", "location": { "latitude": 37.422, "longitude": -122.084, "address": { "country": "US", "locality": "Mountain View", "postal_code": "94043", "street_address": "1600 Amphitheatre Pkwy" } }, "display_address": { "localizations": [ { "locale": "en", "text": "1600 Amphitheatre Pkwy, Mountain View, CA 94043" }, { "locale": "fr", "text": "1600 Amphitheatre Pkwy, Mountain View, CA 94043" } ], "default_locale": "en" }, "images": [ { "url": "https://www.tastybitestest.com/images/interior.jpg", "alt_text": { "localizations": [ { "locale": "en", "text": "Cozy dining area of Tasty Bites" }, { "locale": "fr", "text": "Espace salle à manger accueillant de Tasty Bites" } ], "default_locale": "en" } } ], "rating": 4.7, "num_ratings": 150, "rating_scale": 5, "category": "LOCAL", "description": { "localizations": [ { "locale": "en", "text": "A mock restaurant for testing the POI feed ingestion." }, { "locale": "fr", "text": "Un faux restaurant pour tester l'ingestion de flux de points d'intérêt." } ], "default_locale": "en" }, "local_data": { "establishment_category": { "localizations": [ { "locale": "en", "text": "Restaurant" }, { "locale": "fr", "text": "Restaurant" } ], "default_locale": "en" }, "price_range": { "min_price": { "currency_code": "USD", "units": 15, "nanos": 0 }, "max_price": { "currency_code": "USD", "units": 45, "nanos": 0 } }, "business_hours": { "time_ranges": [ { "open_day": "MONDAY", "open_time": { "hours": 11, "minutes": 0 }, "close_day": "MONDAY", "close_time": { "hours": 21, "minutes": 0 } }, { "open_day": "TUESDAY", "open_time": { "hours": 11, "minutes": 0 }, "close_day": "TUESDAY", "close_time": { "hours": 21, "minutes": 0 } }, { "open_day": "WEDNESDAY", "open_time": { "hours": 11, "minutes": 0 }, "close_day": "WEDNESDAY", "close_time": { "hours": 21, "minutes": 0 } }, { "open_day": "THURSDAY", "open_time": { "hours": 11, "minutes": 0 }, "close_day": "THURSDAY", "close_time": { "hours": 22, "minutes": 0 } }, { "open_day": "FRIDAY", "open_time": { "hours": 11, "minutes": 0 }, "close_day": "FRIDAY", "close_time": { "hours": 23, "minutes": 0 } }, { "open_day": "SATURDAY", "open_time": { "hours": 10, "minutes": 0 }, "close_day": "SATURDAY", "close_time": { "hours": 23, "minutes": 0 } }, { "open_day": "SUNDAY", "open_time": { "hours": 10, "minutes": 0 }, "close_day": "SUNDAY", "close_time": { "hours": 20, "minutes": 0 } } ] }, "brand_landing_pages": [ { "brand_id": "tasty_bites_brand", "localized_landing_pages": [ { "url": "https://www.tastybitestest.com/fr", "locales": ["fr-FR", "fr-CA"] }, { "url": "https://www.tastybitestest.com/en", "locales": ["en-US", "en-GB"] } ], "default_url": "https://www.tastybitestest.com" }, { "brand_id": "delicious_eats_brand", "localized_landing_pages": [ { "url": "https://www.deliciouseats.com/fr", "locales": ["fr-FR", "fr-CA"] }, { "url": "https://www.deliciouseats.com/en", "locales": ["en-US", "en-GB"] } ], "default_url": "https://www.deliciouseats.com" } ] } } ] }