Wenn Sie über die Place Search eine place_id erhalten haben, können Sie mit einer Place Details (Legacy)-Anfrage weitere Details zu einem bestimmten Unternehmen oder POI anfordern. Eine Place Details-Anfrage (Legacy) gibt umfassendere Informationen zum angegebenen Ort zurück, z. B. die vollständige Adresse, die Telefonnummer, die Nutzerbewertung und Rezensionen.
„Place Details (Legacy)“-Anfragen
Eine Place Details-Anfrage (Legacy) ist eine HTTP-URL im folgenden Format:
https://maps.googleapis.com/maps/api/place/details/output?parameters
Dabei kann output einer der folgenden Werte sein:
json(empfohlen) gibt die Ausgabe in JavaScript Object Notation (JSON) an.xmlgibt die Ausgabe als XML an.
Zum Initiieren einer Suchanfrage sind bestimmte Parameter erforderlich. Wie in URLs üblich, werden alle Parameter mit dem Und-Zeichen (&) getrennt. In den folgenden Abschnitten sind die Parameter und ihre möglichen Werte aufgeführt.
Erforderliche Parameter
-
place_id
Eine ID in Textform, die einen Ort eindeutig identifiziert und von einer Place Search (Legacy)-Anfrage zurückgegeben wird. Weitere Informationen finden Sie in der Übersicht zur Orts-ID.
Optionale Parameter
-
Felder
Achtung:Bei Place Search (Legacy)- und Place Details (Legacy)-Anfragen werden nicht die gleichen Felder zurückgegeben. Bei Place Search-Anfragen (Legacy) werden weniger Felder zurückgegeben als bei Place Details-Anfragen (Legacy). Wenn das gewünschte Feld bei einer „Place Search“ (Legacy)-Anfrage nicht zurückgegeben wird, können Sie mit „Place Search“ (Legacy) eineplace_idabrufen und diese Orts-ID dann für eine „Place Details“ (Legacy)-Anfrage verwenden. Weitere Informationen zu den Feldern, die in einer Place Search-Anfrage (Legacy) nicht verfügbar sind, finden Sie unter Ortsdatenfelder (Legacy).Verwenden Sie den Parameter „fields“, um eine durch Kommas getrennte Liste von Ortsdatentypen anzugeben, die zurückgegeben werden sollen. Beispiel:
fields=formatted_address,name,geometry. Verwenden Sie bei zusammengesetzten Werten einen Schrägstrich. Beispiel:opening_hours/open_now.Die Felder sind in drei Abrechnungskategorien unterteilt: Basic, Contact und Atmosphere. Die SKUs „Basic“, „Contact“ und „Atmosphere“ werden zusätzlich zur Basis-SKU („Places Details“, „Find Place“, „Nearby Search“ oder „Text Search“) für die Anfrage berechnet, durch die sie ausgelöst wurden. Weitere Informationen finden Sie in der Preisübersicht.
Basic
Die Kategorie „Basic“ umfasst folgende Felder:
address_components,adr_address,business_status,formatted_address,geometry,icon,icon_mask_base_uri,icon_background_color,name,permanently_closed(eingestellt),photo,place_id,plus_code,type,url,utc_offset,vicinity,wheelchair_accessible_entrance.Kontakt
Die Kategorie „Contact“ umfasst folgende Felder:
current_opening_hours,formatted_phone_number,international_phone_number,opening_hours,secondary_opening_hours,websiteAtmosphere
Die Kategorie „Atmosphere“ umfasst folgende Felder:
curbside_pickup,delivery,dine_in,editorial_summary,price_level,rating,reservable,reviews,serves_beer,serves_breakfast,serves_brunch,serves_dinner,serves_lunch,serves_vegetarian_food,serves_wine,takeout,user_ratings_total.Hinweis:Zuordnungen (html_attributions) werden bei jedem Aufruf zurückgegeben, unabhängig davon, ob das Feld angefordert wurde. -
Sprache
Die Sprache, in der die Ergebnisse zurückgegeben werden sollen.
- Hier finden Sie eine Liste der unterstützten Sprachen. Die unterstützten Sprachen werden regelmäßig von Google aktualisiert, sodass diese Liste unter Umständen nicht vollständig ist.
-
Wenn
languagenicht angegeben ist, versucht die API, die im HeaderAccept-Languageangegebene bevorzugte Sprache zu verwenden. - Die API versucht, eine Adresse anzugeben, die sowohl für den Nutzer als auch für Einheimische lesbar ist. Dazu werden Adressen in der Landessprache zurückgegeben, die bei Bedarf in eine für den Nutzer lesbare Schrift transkribiert werden. Dabei wird die bevorzugte Sprache berücksichtigt. Alle anderen Adressen werden in der bevorzugten Sprache zurückgegeben. Adresskomponenten werden alle in derselben Sprache zurückgegeben, die von der ersten Komponente ausgewählt wird.
- Wenn ein Name in der bevorzugten Sprache nicht verfügbar ist, verwendet die API die nächstgelegene Übereinstimmung.
- Die bevorzugte Sprache hat einen geringen Einfluss auf die von der API zurückgegebenen Ergebnisse und die Reihenfolge, in der sie zurückgegeben werden. Der Geocoder interpretiert Abkürzungen je nach Sprache unterschiedlich, z. B. Abkürzungen für Straßentypen oder Synonyme, die in einer Sprache gültig sind, in einer anderen jedoch nicht. Beispiel: utca und tér sind ungarische Synonyme für „Straße“.
-
Region
Der Regionscode, angegeben als zweistelliger Wert der Ländercode-Top-Level-Domain (ccTLD). Die meisten ccTLD-Codes entsprechen den ISO-3166-1-Codes. Es gibt jedoch einige Ausnahmen. So lautet beispielsweise die ccTLD des Vereinigten Königreichs „uk“ (.co.uk), der ISO-3166-1-Code dagegen „gb“ (technisch gesehen für die Entität „Vereinigtes Königreich Großbritannien und Nordirland“).
-
reviews_no_translations
Geben Sie
reviews_no_translations=truean, um die Übersetzung von Rezensionen zu deaktivieren. Geben Siereviews_no_translations=falsean, um die Übersetzung von Rezensionen zu aktivieren. Rezensionen werden in ihrer Originalsprache zurückgegeben.Wenn der Parameter weggelassen oder ohne Wert übergeben wird, ist die Übersetzung von Rezensionen aktiviert. Wenn der Parameter
languagein der Anfrage angegeben wurde, wird die angegebene Sprache als bevorzugte Sprache für die Übersetzung verwendet. Wennlanguageweggelassen wird, versucht die API, den HeaderAccept-Languageals bevorzugte Sprache zu verwenden. -
reviews_sort
Die Sortiermethode, die beim Zurückgeben von Rezensionen verwendet werden soll. Kann auf
most_relevant(Standard) odernewestfestgelegt werden.-
Bei
most_relevant(Standard) werden Rezensionen nach Relevanz sortiert. Der Dienst bevorzugt Ergebnisse, die ursprünglich in der bevorzugten Sprache verfasst wurden. -
Bei
newestwerden Rezensionen in chronologischer Reihenfolge sortiert. Die bevorzugte Sprache hat keinen Einfluss auf die Sortierreihenfolge.
Google empfiehlt, dem Endnutzer anzuzeigen, wie die Rezensionen sortiert werden.
-
Bei
-
sessiontoken
Ein zufälliger String, der eine Sitzung für die automatische Vervollständigung zu Abrechnungszwecken identifiziert.
Die Sitzung wird gestartet, wenn der Nutzer mit der Eingabe beginnt, und endet, wenn er einen Ort auswählt und ein Aufruf von „Place Details (Legacy)“ erfolgt. Jede Sitzung kann mehrere Abfragen und eine Ortsauswahl umfassen. Die API-Schlüssel, die für die einzelnen Anfragen innerhalb einer Sitzung verwendet werden, müssen zum selben Google Cloud Console-Projekt gehören. Sobald eine Sitzung beendet wird, ist das Token nicht mehr gültig. Ihre Anwendung muss für jede Sitzung ein neues Token generieren. Wenn Sie den
sessiontoken-Parameter weglassen oder ein Sitzungstoken wiederverwenden, wird die Sitzung so in Rechnung gestellt, als wäre kein Sitzungstoken bereitgestellt worden. Jede Anfrage wird separat abgerechnet.Wir empfehlen folgende Richtlinien:
- Verwenden Sie Sitzungstokens für alle Sitzungen, bei denen eine automatische Vervollständigung erfolgt.
- Generieren Sie für jede Sitzung ein neues Token. Ein UUID der Version 4 wird empfohlen.
- Achten Sie darauf, dass die API-Schlüssel, die für alle „Place Autocomplete“- und „Place Details“-Anfragen innerhalb einer Sitzung verwendet werden, zum selben Cloud Console-Projekt gehören.
- Für jede neue Sitzung muss ein eindeutiges Sitzungstoken weitergegeben werden. Wenn Sie dasselbe Token für mehr als eine Sitzung verwenden, wird jede Anfrage separat in Rechnung gestellt.
Beispiel für Place Details (Legacy)
Im folgenden Beispiel werden die Details eines Ortes anhand der place_id angefordert. Die Felder name, rating und formatted_phone_number sind enthalten:
Muschel
curl -L -X GET 'https://maps.googleapis.com/maps/api/place/details/json?place_id=ChIJN1t_tDeuEmsRUsoyG83frY4&fields=name%2Crating%2Cformatted_phone_number&key=YOUR_API_KEY'
HTTP
https://maps.googleapis.com/maps/api/place/details/json ?fields=name%2Crating%2Cformatted_phone_number &place_id=ChIJN1t_tDeuEmsRUsoyG83frY4 &key=YOUR_API_KEY
Ersetzen Sie den Schlüssel in diesem Beispiel durch Ihren eigenen API-Schlüssel, damit die Anfrage in Ihrer Anwendung funktioniert.
Place Details (Legacy)-Antwort
Place Details (Legacy)-Antworten werden in dem Format zurückgegeben, das durch das Flag output im URL-Pfad der Anfrage angegeben ist.
JSON
{ "html_attributions": [], "result": { "address_components": [ { "long_name": "48", "short_name": "48", "types": ["street_number"] }, { "long_name": "Pirrama Road", "short_name": "Pirrama Rd", "types": ["route"], }, { "long_name": "Pyrmont", "short_name": "Pyrmont", "types": ["locality", "political"], }, { "long_name": "City of Sydney", "short_name": "City of Sydney", "types": ["administrative_area_level_2", "political"], }, { "long_name": "New South Wales", "short_name": "NSW", "types": ["administrative_area_level_1", "political"], }, { "long_name": "Australia", "short_name": "AU", "types": ["country", "political"], }, { "long_name": "2009", "short_name": "2009", "types": ["postal_code"], }, ], "adr_address": "48 Pirrama Rd, Pyrmont NSW 2009, Australia", "business_status": "OPERATIONAL", "formatted_address": "48 Pirrama Rd, Pyrmont NSW 2009, Australia", "formatted_phone_number": "(02) 9374 4000", "geometry": { "location": { "lat": -33.866489, "lng": 151.1958561 }, "viewport": { "northeast": { "lat": -33.8655112697085, "lng": 151.1971156302915 }, "southwest": { "lat": -33.86820923029149, "lng": 151.1944176697085 }, }, }, "icon": "https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/generic_business-71.png", "icon_background_color": "#7B9EB0", "icon_mask_base_uri": "https://maps.gstatic.com/mapfiles/place_api/icons/v2/generic_pinlet", "international_phone_number": "+61 2 9374 4000", "name": "Google Workplace 6", "opening_hours": { "open_now": false, "periods": [ { "close": { "day": 1, "time": "1700" }, "open": { "day": 1, "time": "0900" }, }, { "close": { "day": 2, "time": "1700" }, "open": { "day": 2, "time": "0900" }, }, { "close": { "day": 3, "time": "1700" }, "open": { "day": 3, "time": "0900" }, }, { "close": { "day": 4, "time": "1700" }, "open": { "day": 4, "time": "0900" }, }, { "close": { "day": 5, "time": "1700" }, "open": { "day": 5, "time": "0900" }, }, ], "weekday_text": [ "Monday: 9:00 AM – 5:00 PM", "Tuesday: 9:00 AM – 5:00 PM", "Wednesday: 9:00 AM – 5:00 PM", "Thursday: 9:00 AM – 5:00 PM", "Friday: 9:00 AM – 5:00 PM", "Saturday: Closed", "Sunday: Closed", ], }, "photos": [ { "height": 3024, "html_attributions": [ "Cynthia Wei", ], "photo_reference": "Aap_uEC6jqtpflLS8GxQqPHBjlcwBf2sri0ZErk9q1ciHGZ6Zx5HBiiiEsPEO3emtB1PGyWbBQhgPL2r9CshoVlJEG4xzB71QMhGBTqqeaCNk1quO3vTTiP50aM1kmOaBQ-DF1ER7zpu6BQOEtnusKMul0m4KA45wfE3h6Xh2IxjLNzx-IiX", "width": 4032, }, { "height": 3264, "html_attributions": [ "Heyang Li", ], "photo_reference": "Aap_uECyRjHhOQgGaKTW6Z3ZfTEaDhNc44m0F6GrNSFIMffixwI5xqD35QhecdzVY-FUuDtVE1huu8-2HkxgI9Gwvy6W18fU-_E3UUkdSFBQqGK8_slKlT8BZZc66sTX53IEcTDrZfT-E5_YUBYBOm13yxOTOfWfEDABhaxCGC5Hu_XYh0fI", "width": 4912, }, // ... ], "place_id": "ChIJN1t_tDeuEmsRUsoyG83frY4", "plus_code": { "compound_code": "45MW+C8 Pyrmont NSW, Australia", "global_code": "4RRH45MW+C8", }, "rating": 4, "reference": "ChIJN1t_tDeuEmsRUsoyG83frY4", "reviews": [ { "author_name": "Luke Archibald", "author_url": "https://www.google.com/maps/contrib/113389359827989670652/reviews", "language": "en", "profile_photo_url": "https://lh3.googleusercontent.com/a-/AOh14GhGGmTmvtD34HiRgwHdXVJUTzVbxpsk5_JnNKM5MA=s128-c0x00000000-cc-rp-mo", "rating": 1, "relative_time_description": "a week ago", "text": "Beautiful building with a great view.", "time": 1652286798, }, { "author_name": "Tevita Taufoou", "author_url": "https://www.google.com/maps/contrib/105937236918123663309/reviews", "language": "en", "profile_photo_url": "https://lh3.googleusercontent.com/a/AATXAJwZANdRSSg96QeZG--6BazG5uv_BJMIvpZGqwSz=s128-c0x00000000-cc-rp-mo", "rating": 1, "relative_time_description": "6 months ago", "text": "Conference rooms were well equipped.", "time": 1637215605, }, // ... ], "types": ["point_of_interest", "establishment"], "url": "https://maps.google.com/?cid=10281119596374313554", "user_ratings_total": 939, "utc_offset": 600, "vicinity": "48 Pirrama Road, Pyrmont", "website": "http://google.com/", }, "status": "OK", }
XML
<?xml version="1.0" encoding="UTF-8"?> <PlaceDetailsResponse> <status>OK</status> <result> <name>Google Workplace 6</name> <vicinity>48 Pirrama Road, Pyrmont</vicinity> <type>point_of_interest</type> <type>establishment</type> <formatted_phone_number>(02) 9374 4000</formatted_phone_number> <formatted_address>48 Pirrama Rd, Pyrmont NSW 2009, Australia</formatted_address> <address_component> <long_name>48</long_name> <short_name>48</short_name> <type>street_number</type> </address_component> <address_component> <long_name>Pirrama Road</long_name> <short_name>Pirrama Rd</short_name> <type>route</type> </address_component> <address_component> <long_name>Pyrmont</long_name> <short_name>Pyrmont</short_name> <type>locality</type> <type>political</type> </address_component> <address_component> <long_name>City of Sydney</long_name> <short_name>City of Sydney</short_name> <type>administrative_area_level_2</type> <type>political</type> </address_component> <address_component> <long_name>New South Wales</long_name> <short_name>NSW</short_name> <type>administrative_area_level_1</type> <type>political</type> </address_component> <address_component> <long_name>Australia</long_name> <short_name>AU</short_name> <type>country</type> <type>political</type> </address_component> <address_component> <long_name>2009</long_name> <short_name>2009</short_name> <type>postal_code</type> </address_component> <geometry> <location> <lat>-33.8664890</lat> <lng>151.1958561</lng> </location> <viewport> <southwest> <lat>-33.8682092</lat> <lng>151.1944177</lng> </southwest> <northeast> <lat>-33.8655113</lat> <lng>151.1971156</lng> </northeast> </viewport> </geometry> <rating>4.0</rating> <url>https://maps.google.com/?cid=10281119596374313554</url> <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/generic_business-71.png</icon> <reference>ChIJN1t_tDeuEmsRUsoyG83frY4</reference> <international_phone_number>+61 2 9374 4000</international_phone_number> <website>http://google.com/</website> <review> <time>1652286798</time> <text>Beautiful building with a great view.</text> <author_name>Luke Archibald</author_name> <author_url>https://www.google.com/maps/contrib/113389359827989670652/reviews</author_url> <rating>1.0</rating> <language>en</language> <profile_photo_url>https://lh3.googleusercontent.com/a-/AOh14GhGGmTmvtD34HiRgwHdXVJUTzVbxpsk5_JnNKM5MA=s128-c0x00000000-cc-rp-mo</profile_photo_url> <relative_time_description>a week ago</relative_time_description> </review> <review> <time>1637215605</time> <text>Conference rooms were well equipped.</text> <author_name>Joe Schmoe</author_name> <author_url>https://www.google.com/maps/contrib/105937236918123663309/reviews</author_url> <rating>1.0</rating> <language>en</language> <profile_photo_url>https://lh3.googleusercontent.com/a/AATXAJwZANdRSSg96QeZG--6BazG5uv_BJMIvpZGqwSz=s128-c0x00000000-cc-rp-mo</profile_photo_url> <relative_time_description>6 months ago</relative_time_description> </review> <!-- ... --> <opening_hours> <open_now>false</open_now> <period> <open> <day>1</day> <time>0900</time> </open> <close> <day>1</day> <time>1700</time> </close> </period> <period> <open> <day>2</day> <time>0900</time> </open> <close> <day>2</day> <time>1700</time> </close> </period> <period> <open> <day>3</day> <time>0900</time> </open> <close> <day>3</day> <time>1700</time> </close> </period> <period> <open> <day>4</day> <time>0900</time> </open> <close> <day>4</day> <time>1700</time> </close> </period> <period> <open> <day>5</day> <time>0900</time> </open> <close> <day>5</day> <time>1700</time> </close> </period> <weekday_text>Monday: 9:00 AM – 5:00 PM</weekday_text> <weekday_text>Tuesday: 9:00 AM – 5:00 PM</weekday_text> <weekday_text>Wednesday: 9:00 AM – 5:00 PM</weekday_text> <weekday_text>Thursday: 9:00 AM – 5:00 PM</weekday_text> <weekday_text>Friday: 9:00 AM – 5:00 PM</weekday_text> <weekday_text>Saturday: Closed</weekday_text> <weekday_text>Sunday: Closed</weekday_text> </opening_hours> <utc_offset>600</utc_offset> <photo> <photo_reference>Aap_uEDT4DC26Lk_VoI6CvsZl1NzU7BOPjEyqEHlf8tCA0hFtlrsI1Tmed_LmjSUQghWnZq-E7SsYZSlvGP0X5ZAfH6w0Tmw6biO4PPI8BTPwvo6FqLfZgC2RGNQyI81HRnJGB3ZJUAYEXvxBfA_upEcsITxk52joPkK9d7cfFptY0z-Oy7Y</photo_reference> <width>4032</width> <height>3024</height> <html_attribution><a href="https://maps.google.com/maps/contrib/117600448889234589608">Cynthia Wei</a></html_attribution> </photo> <photo> <photo_reference>Aap_uEAPNVkxDxxHa0aRFAkA2gMygFUuaKujSSv-zdad_vuaxTkaDHgX-aVPeNATp7VEgwqa3A3QutoeKdDd6aGZPBPCLl8XTf1vYckEBxIWEXZjFlMXK2TwIVfe4qa6O31AbYQQ5TCrEs9nz2fuBBWJwifTiKIIrv4NrEpQok6i8nnn8xKS</photo_reference> <width>4912</width> <height>3264</height> <html_attribution><a href="https://maps.google.com/maps/contrib/102493344958625549078">Heyang Li</a></html_attribution> </photo> <!-- ... --> <adr_address><span class="street-address">48 Pirrama Rd</span>, <span class="locality">Pyrmont</span> <span class="region">NSW</span> <span class="postal-code">2009</span>, <span class="country-name">Australia</span></adr_address> <user_ratings_total>939</user_ratings_total> <place_id>ChIJN1t_tDeuEmsRUsoyG83frY4</place_id> <plus_code> <global_code>4RRH45MW+C8</global_code> <compound_code>45MW+C8 Pyrmont NSW, Australia</compound_code> </plus_code> <icon_background_color>#7B9EB0</icon_background_color> <business_status>OPERATIONAL</business_status> <icon_mask_base_uri>https://maps.gstatic.com/mapfiles/place_api/icons/v2/generic_pinlet</icon_mask_base_uri> </result> </PlaceDetailsResponse>
JSON- und XML-Antworten enthalten jeweils die folgenden Elemente:
PlacesDetailsResponse
| Feld | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
|
required | Array<string> |
Kann eine Reihe von Quellenangaben zu diesem Eintrag enthalten, die dem Nutzer angezeigt werden müssen. Einige Einträge haben möglicherweise keine Quellenangabe. |
|
required | Ort |
Enthält die detaillierten Informationen zum angeforderten Ort. Weitere Informationen finden Sie unter Place. |
|
required | PlacesDetailsStatus |
Enthält den Status der Anfrage und evtl. Debugging-Informationen, mit deren Hilfe Sie herausfinden können, warum die Anfrage zu Fehlern geführt hat. Weitere Informationen finden Sie unter PlacesDetailsStatus. |
|
optional | Array<string> |
Wenn der Dienst zusätzliche Informationen zur Anfragespezifikation zurückgibt, kann das Antwortobjekt ein zusätzliches |
In einer JSON-Antwort werden diese als Stammelemente dargestellt. In einer XML-Antwort werden diese als Elemente der obersten Ebene unter <PlaceDetailsResponse> angezeigt.
PlacesDetailsStatus
Vom Dienst zurückgegebene Statuscodes.
OK: Die API-Anfrage war erfolgreich.-
ZERO_RESULTS: Der referenzierte Ortplace_idwar gültig, verweist aber nicht mehr auf ein gültiges Ergebnis. Dies kann vorkommen, wenn die Einrichtung nicht mehr existiert. -
NOT_FOUND: Der entsprechende Ort (place_id) wurde in der Places-Datenbank nicht gefunden. -
INVALID_REQUEST: Die API-Anfrage war falsch formatiert. -
OVER_QUERY_LIMIT, der auf Folgendes hinweist:- Sie haben die maximal zulässige Anzahl von Abfragen pro Sekunde überschritten.
- Die Abrechnung wurde für Ihr Konto nicht aktiviert.
- Das monatliche Guthaben von 200 $ oder ein von Ihnen festgelegtes Nutzungslimit wurde überschritten.
- Die angegebene Zahlungsmethode ist nicht mehr gültig. Das kann z. B. bei einer abgelaufenen Kreditkarte der Fall sein.
-
REQUEST_DENIEDgibt an, dass Ihre Anfrage abgelehnt wurde, im Allgemeinen aus folgenden Gründen:- In der Anfrage fehlt ein API-Schlüssel.
- Der Parameter
keyist ungültig.
UNKNOWN_ERROR: Ein unbekannter Fehler ist aufgetreten.
Ort
Attribute, die einen Ort beschreiben. Nicht alle Attribute sind für alle Ortstypen verfügbar.
| Feld | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
|
optional |
Array<AddressComponent>
|
Ein Array, das die einzelnen Komponenten für diese Adresse enthält.
Weitere Informationen finden Sie unter |
|
optional | String |
Eine Darstellung der Adresse des Ortes im adr-Mikroformat. |
|
optional | String |
Gibt den Öffnungsstatus des Ortes an, sofern es sich um ein Unternehmen handelt.
Wenn keine Daten vorhanden sind, wird für
The allowed values include:
OPERATIONAL,
CLOSED_TEMPORARILY, and CLOSED_PERMANENTLY
|
|
optional | boolean |
Gibt an, ob das Unternehmen die Abholung vor dem Laden unterstützt. |
|
optional | PlaceOpeningHours |
Enthält die Öffnungszeiten für die nächsten sieben Tage (einschließlich heute). Der Zeitraum beginnt um Mitternacht am Tag der Anfrage und endet sechs Tage später um 23:59 Uhr. Dieses Feld enthält das Unterfeld Weitere Informationen finden Sie unter PlaceOpeningHours. |
|
optional | boolean |
Gibt an, ob das Unternehmen einen Lieferservice anbietet. |
|
optional | boolean |
Gibt an, ob das Unternehmen Sitzplätze im Innen- oder Außenbereich anbietet. |
|
optional | PlaceEditorialSummary |
Enthält eine Zusammenfassung des Orts. Eine Zusammenfassung besteht aus einer Textübersicht und enthält gegebenenfalls auch den Sprachcode für diese. Der Zusammenfassungstext muss unverändert dargestellt werden und darf nicht modifiziert oder geändert werden. Weitere Informationen finden Sie unter PlaceEditorialSummary. |
|
optional | String |
Ein String, der die menschenlesbare Adresse dieses Ortes enthält. Diese Adresse stimmt häufig mit der Postanschrift überein. In einigen Ländern, z. B. dem Vereinigten Königreich, ist die Weitergabe echter Postanschriften aufgrund von Lizenzeinschränkungen nicht zulässig. Die formatierte Adresse besteht aus einer oder mehreren Adresskomponenten. Die Adresse „111 8th Avenue, New York, NY“ besteht z. B. aus den folgenden Komponenten: „111“ (Hausnummer), „8th Avenue“ (Straße), „New York“ (Stadt) und „NY“ (US-Bundesstaat). Wir raten davon ab, die formatierte Adresse programmatisch zu parsen. Verwenden Sie stattdessen die einzelnen Adresskomponenten, die zusätzlich zur formatierten Adresse in der API-Antwort enthalten sind. |
|
optional | String |
Enthält die Telefonnummer des Ortes im lokalen Format. |
|
optional | Geometry |
Enthält den Standort und den Darstellungsbereich für den Standort. Weitere Informationen findest du unter |
|
optional | String |
Enthält die URL eines vorgeschlagenen Symbols, das dem Nutzer angezeigt werden kann, wenn dieses Ergebnis auf einer Karte dargestellt wird. |
|
optional | String |
Enthält den standardmäßigen Hex-Farbcode für die Kategorie des Orts. |
|
optional | String |
Enthält die URL eines empfohlenen Symbols ohne die Dateityperweiterung |
|
optional | String |
Enthält die Telefonnummer des Ortes im internationalen Format.
Das internationale Format umfasst die Ländervorwahl mit einem vorangestellten Pluszeichen (+). Die international_phone_number für die Google-Niederlassung in Sydney, Australien, ist z. B. |
|
optional | String |
Enthält den menschenlesbaren Namen für das zurückgegebene Ergebnis. Bei |
|
optional | PlaceOpeningHours |
Enthält die regulären Öffnungszeiten. Weitere Informationen finden Sie unter PlaceOpeningHours. |
|
optional | boolean |
Nutzen Sie |
|
optional | Array<PlacePhoto> |
Ein Array von Fotoobjekten, die jeweils einen Verweis auf ein Bild enthalten. Bei einer Anfrage können bis zu zehn Fotos zurückgegeben werden. Weitere Informationen zu Fotos von Orten und dazu, wie Sie die Bilder in Ihrer Anwendung verwenden können, finden Sie in der Dokumentation zu Place Photos. Weitere Informationen finden Sie unter PlacePhoto. |
|
optional | String |
Eine ID in Textform, die einen Ort eindeutig bezeichnet. Übergeben Sie die Kennung im Feld |
|
optional | PlusCode |
Ein codierter Verweis auf den Standort, der sich aus den Koordinaten (Breiten- und Längengrad) ableiten lässt und einen Bereich definiert: 1/8.000stel eines Grades mal 1/8.000stel eines Grades (ca. 14 m × 14 m am Äquator) oder kleiner. Plus Codes können als Ersatz für Adressen verwendet werden, wenn keine Adressen vorhanden sind, z. B. wenn Gebäude keine Hausnummern oder Straßen keine Namen haben. Weitere Informationen finden Sie unter Open Location Code und Plus Codes. Weitere Informationen findest du unter |
|
optional | Zahl |
Das Preisniveau des Ortes auf einer Skala von 0 bis 4. Der genaue Betrag, der durch einen bestimmten Wert angegeben wird, variiert von Region zu Region. Die Preisstufen werden so interpretiert:
|
|
optional | Zahl |
Enthält die Bewertung des Ortes. Sie beruht auf aggregierten Nutzerrezensionen und liegt zwischen 1, 0 und 5, 0. |
|
optional | String | |
|
optional | boolean |
Gibt an, ob der Ort Reservierungen unterstützt. |
|
optional | Array<PlaceReview> |
Ein JSON-Array mit bis zu fünf Rezensionen. Standardmäßig sind die Rezensionen nach Relevanz sortiert. Verwenden Sie den Anfrageparameter
Google empfiehlt, Nutzern anzuzeigen, ob die Ergebnisse nach Weitere Informationen findest du unter PlaceReview. |
|
optional | String | |
|
optional | Array<PlaceOpeningHours> |
Enthält ein Array von Einträgen für die nächsten sieben Tage, einschließlich Informationen zu den Nebenöffnungszeiten eines Unternehmens. Diese unterscheiden sich von den regulären Öffnungszeiten eines Unternehmens. Ein Restaurant kann beispielsweise Drive-in- oder Lieferzeiten als sekundäre Öffnungszeiten angeben. In diesem Feld wird das Unterfeld Weitere Informationen finden Sie unter PlaceOpeningHours. |
|
optional | boolean |
Gibt an, ob an diesem Ort Bier serviert wird. |
|
optional | boolean |
Gibt an, ob im Ort Frühstück serviert wird. |
|
optional | boolean |
Gibt an, ob im Restaurant Brunch angeboten wird. |
|
optional | boolean |
Gibt an, ob hier Abendessen serviert wird. |
|
optional | boolean |
Gibt an, ob am Ort Mittagessen serviert wird. |
|
optional | boolean |
Gibt an, ob am Ort vegetarische Speisen serviert werden. |
|
optional | boolean |
Gibt an, ob am Ort Wein serviert wird. |
|
optional | boolean |
Gibt an, ob das Unternehmen Gerichte zum Mitnehmen anbietet. |
|
optional | Array<string> |
Enthält ein Array von Elementtypen, die das angegebene Ergebnis beschreiben. Sehen Sie sich die Liste der unterstützten Typen an. |
|
optional | String |
Die URL der offiziellen Google-Seite für diesen Ort. Es handelt sich dabei um die Google-eigene Seite, die die bestmöglichen Informationen zum Ort enthält. In Anwendungen muss diese Seite verlinkt oder eingebettet sein und zwar auf jedem Bildschirm, auf dem detaillierte Ergebnisse zu diesem Ort für den Nutzer angezeigt werden. |
|
optional | Zahl |
Die Gesamtzahl der Rezensionen mit oder ohne Text für diesen Ort. |
|
optional | Zahl |
Enthält die Anzahl der Minuten, um die die aktuelle Zeitzone dieses Ortes von der UTC abweicht. Beispiel: Für Orte in Sydney, Australien, während der Sommerzeit wäre dies 660 (+11 Stunden ab UTC) und für Orte in Kalifornien außerhalb der Sommerzeit -480 (-8 Stunden ab UTC). |
|
optional | String |
Bei Ergebnissen für Einrichtungen (
Bei allen anderen Ergebnissen enthält das Feld Der Inhalt ist so zu lesen, wie er ist. Die formatierte Adresse darf nicht programmatisch geparst werden. |
|
optional | String |
Die offizielle Website des Ortes, z. B. die Homepage eines Unternehmens. |
|
optional | boolean |
Gibt an, ob der Ort einen rollstuhlgerechten Eingang hat. |
PlaceEditorialSummary
Enthält eine Zusammenfassung des Orts. Eine Zusammenfassung besteht aus einer Textübersicht und enthält gegebenenfalls auch den Sprachcode für diese. Der Zusammenfassungstext muss unverändert dargestellt werden und darf nicht modifiziert oder geändert werden.
| Feld | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
|
optional | String |
Die Sprache der vorherigen Felder. Möglicherweise nicht immer vorhanden. |
|
optional | String |
Eine mittellange Zusammenfassung des Ortes in Textform. |
PlaceOpeningHours
Ein Objekt, das die Öffnungszeiten eines Orts beschreibt.
| Feld | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
|
optional | boolean |
Ein boolescher Wert, der angibt, ob der Ort derzeit geöffnet ist. |
|
optional | Array<PlaceOpeningHoursPeriod> |
Ein Array mit Öffnungszeiten in einem Zeitraum von 7 Tagen in chronologischer Reihenfolge, beginnend am Sonntag. Weitere Informationen finden Sie unter PlaceOpeningHoursPeriod. |
|
optional | Array<PlaceSpecialDay> |
Ein Array mit bis zu sieben Einträgen für die nächsten sieben Tage. Weitere Informationen finden Sie unter PlaceSpecialDay. |
|
optional | String |
Ein Typstring, der verwendet wird, um den Typ der sekundären Öffnungszeiten zu identifizieren (z. B. |
|
optional | Array<string> |
Ein Array von Strings, die die Öffnungszeiten des Ortes in menschenlesbarem Text beschreiben. |
PlaceOpeningHoursPeriod
| Feld | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
|
required | PlaceOpeningHoursPeriodDetail |
Enthält ein Paar aus Tages- und Zeitobjekten, die beschreiben, wann der Ort geöffnet hat. Weitere Informationen finden Sie unter PlaceOpeningHoursPeriodDetail. |
|
optional | PlaceOpeningHoursPeriodDetail |
Kann ein Paar aus Tages- und Zeitobjekten enthalten, die beschreiben, wann der Ort geschlossen hat. Wenn ein Ort immer geöffnet ist, fehlt der Abschnitt „close“ in der Antwort. Ist der Ort immer geöffnet, wird in der Anwendung der Zeitraum „open“ mit „day“ mit dem Wert Weitere Informationen finden Sie unter PlaceOpeningHoursPeriodDetail. |
PlaceSpecialDay
| Feld | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
|
optional | String |
Ein Datum im RFC3339-Format in der lokalen Zeitzone für den Ort, z. B. 2010-12-31. |
|
optional | boolean |
„True“, wenn es für diesen Tag besondere Öffnungszeiten gibt. Wenn |
PlaceOpeningHoursPeriodDetail
| Feld | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
|
erforderlich | Zahl |
Eine Zahl von 0 bis 6, die dem Wochentag entspricht, beginnend mit Sonntag. Beispiel: 2 bedeutet Dienstag. |
|
required | String |
Kann eine Uhrzeit im 24-Stunden-Format (hhmm) enthalten. Die Werte liegen im Bereich von 0000 bis 2359. Die Zeit wird in der Zeitzone des Ortes angegeben. |
|
optional | String |
Ein Datum im RFC3339-Format in der lokalen Zeitzone für den Ort, z. B. 2010-12-31. |
|
optional | boolean |
„True“, wenn ein bestimmter Zeitraum aufgrund einer siebentägigen Frist gekürzt wurde, wobei der Zeitraum vor Mitternacht am Datum der Anfrage beginnt und/oder um oder nach Mitternacht am letzten Tag endet. Diese Property gibt an, dass der Zeitraum für das Öffnen oder Schließen über diese siebentägige Frist hinausgehen kann. |
PlacePhoto
Ein Foto eines Ortes. Auf das Foto kann mit der Place Photo API über eine URL im folgenden Format zugegriffen werden:
https://maps.googleapis.com/maps/api/place/photo?maxwidth=400&photo_reference=photo_reference&key=YOUR_API_KEY
Weitere Informationen finden Sie unter Place Photos.
| Feld | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
|
erforderlich | Zahl |
Die Höhe des Fotos. |
|
required | Array<string> |
Die HTML-Attribute für das Foto. |
|
required | String |
Ein String, mit dem das Foto identifiziert wird, wenn Sie eine Fotoanfrage stellen. |
|
required | Zahl |
Die Breite des Fotos. |
PlaceReview
Eine von einem Nutzer eingereichte Rezension des Ortes.
| Feld | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
|
erforderlich | String |
Der Name des Nutzers, der die Rezension geschrieben hat. Anonyme Rezensionen werden mit „Ein Google-Nutzer“ gekennzeichnet. |
|
required | Zahl |
Die Gesamtbewertung des Nutzers für diesen Ort. Der Wert wird als Ganzzahl zwischen 1 und 5 angegeben. |
|
required | String |
Der Zeitpunkt, zu dem die Rezension eingereicht wurde, als Text, relativ zur aktuellen Zeit. |
|
required | Zahl |
Der Zeitpunkt, zu dem die Rezension eingereicht wurde, gemessen in Sekunden seit dem 1. Januar 1970 um Mitternacht UTC. |
|
optional | String |
Die URL des Google Maps Local Guides-Profils des Nutzers, sofern vorhanden. |
|
optional | String |
Ein IETF-Sprachcode, der die Sprache der zurückgegebenen Rezension angibt.Dieses Feld enthält nur das primäre Tag für die Sprache, nicht das sekundäre Tag für Land oder Region. Alle englischsprachigen Rezensionen erhalten z. B. das Tag „en“ und nicht „en-AU“ oder „en-UK“ usw. Dieses Feld ist leer, wenn nur eine Bewertung ohne Rezensionstext vorhanden ist. |
|
optional | String |
Ein IETF-Sprachcode, der die Originalsprache der Rezension angibt. Wenn die Rezension übersetzt wurde, ist |
|
optional | String |
Die URL zum Profilbild des Nutzers, falls verfügbar. |
|
optional | String |
Die Rezension des Nutzers. Wenn Sie eine Rezension für einen Ort in Google Places erstellen, sind Rezensionen in Textform optional. Daher kann dieses Feld leer sein. Dieses Feld kann einfaches HTML-Markup enthalten. Beispielsweise kann die Entitätsreferenz |
|
optional | boolean |
Ein boolescher Wert, der angibt, ob die Rezension aus der Originalsprache übersetzt wurde, in der sie verfasst wurde.Wenn eine Rezension übersetzt wurde, was dem Wert „true“ entspricht, empfiehlt Google, dies den Nutzern mitzuteilen. Sie können der Rezension beispielsweise den folgenden String hinzufügen: „Übersetzt von Google“. |