Sobald Sie eine place_id aus einer Ortssuche haben, können Sie weitere Details zu einem bestimmten Unternehmen oder einer Sehenswürdigkeit anfordern, indem Sie eine „Place Details (Legacy)“-Anfrage senden. Bei einer Place Details-Anfrage (Legacy) werden umfassendere Informationen zum angegebenen Ort zurückgegeben, z. B. die vollständige Adresse, Telefonnummer, Nutzerbewertungen oder Rezensionen.
„Place Details (Legacy)“-Anfragen
Eine Place Details (Legacy)-Anfrage ist eine HTTP-URL im folgenden Format:
https://maps.googleapis.com/maps/api/place/details/output?parameters
Dabei kann output einen der folgenden Werte haben:
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. Unten finden Sie eine Liste der Parameter und ihrer möglichen Werte.
Erforderliche Parameter
-
place_id
Eine Kennung in Textform, die einen Ort eindeutig identifiziert und von einer Ortssuche zurückgegeben wird. Weitere Informationen zu Orts-IDs finden Sie in der Übersicht zur Orts-ID.
Optionale Parameter
-
Felder
Achtung:Bei Place Search- und Place Details-Anfragen werden nicht die gleichen Felder zurückgegeben. Bei Place Search-Anfragen wird jeweils ein Teil der Felder zurückgegeben, die bei Place Details-Anfragen zurückgegeben werden. Wenn das gewünschte Feld bei einer „Place Search“-Anfrage nicht zurückgegeben wird, können Sie mit „Place Search“ eineplace_idabrufen und diese ID dann für eine „Place Details“-Anfrage verwenden. Weitere Informationen zu den Feldern, die in einer Place Search-Anfrage nicht verfügbar sind, finden Sie unter Unterstützung von Places API-Feldern.Verwenden Sie den Parameter „fields“, um eine durch Kommas getrennte Liste der zurückzugebenden Ortsdatentypen anzugeben. 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 in Rechnung gestellt, die sie ausgelöst hat. Weitere Informationen finden Sie im Preisblatt.
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:Quellenangaben (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. Diese Liste ist daher möglicherweise nicht vollständig.
-
Wenn
languagenicht angegeben ist, versucht die API, die bevorzugte Sprache zu verwenden, die imAccept-Language-Header angegeben ist. - Die API versucht, eine Straßenadresse bereitzustellen, die sowohl für den Nutzer als auch für Einheimische lesbar ist. Dazu werden Straßenadressen in der lokalen Sprache zurückgegeben, die bei Bedarf in ein für den Nutzer lesbares Schriftsystem transliteriert werden. Dabei wird die bevorzugte Sprache berücksichtigt. Alle anderen Adressen werden in der bevorzugten Sprache zurückgegeben. Alle Adresskomponenten werden in derselben Sprache zurückgegeben, die anhand der ersten Komponente ausgewählt wird.
- Wenn ein Name in der bevorzugten Sprache nicht verfügbar ist, wird die nächstgelegene Übereinstimmung verwendet.
- Die bevorzugte Sprache hat einen geringen Einfluss auf die Ergebnisse, die von der API zurückgegeben werden, und auf 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 sein können, in einer anderen jedoch nicht. utca und tér sind beispielsweise Synonyme für „Straße“ auf Ungarisch.
-
Region
Der Regionscode, angegeben als zweistelliger Ländercode der Top-Level-Domain (ccTLD). Die meisten ccTLD-Codes sind mit den ISO 3166-1-Codes identisch. Es gibt jedoch einige Ausnahmen. Die ccTLD des Vereinigten Königreichs ist beispielsweise „uk“ (.co.uk), der ISO 3166-1-Code „gb“ (technisch für das Land „Vereinigtes Königreich Großbritannien und Nordirland“).
-
reviews_no_translations
Geben Sie
reviews_no_translations=truean, um die Übersetzung von Rezensionen zu deaktivieren, undreviews_no_translations=false, um sie zu aktivieren. Rezensionen werden in der Originalsprache zurückgegeben.Wenn dieser Parameter weggelassen oder ohne Wert übergeben wird, ist die Übersetzung von Rezensionen aktiviert. Wenn der Parameter
languagein der Anfrage angegeben wurde, verwenden Sie die angegebene Sprache als bevorzugte Sprache für die Übersetzung. Wennlanguagenicht angegeben ist, 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 gewichtet die Ergebnisse so, dass Rezensionen zurückgegeben werden, 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, Endnutzern anzuzeigen, wie die Rezensionen sortiert werden.
-
Bei
-
sessiontoken
Ein zufälliger String, der eine Autocomplete-Sitzung 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“ 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 App 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. Die Verwendung eines 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 Orts anhand von place_id angefordert. Die Felder name, rating und formatted_phone_number sind enthalten:
URL
https://maps.googleapis.com/maps/api/place/details/json ?fields=name%2Crating%2Cformatted_phone_number &place_id=ChIJN1t_tDeuEmsRUsoyG83frY4 &key=YOUR_API_KEY
cURL
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'
Hinweis: Sie müssen den Schlüssel in diesem Beispiel durch Ihren eigenen API-Schlüssel ersetzen, damit die Anfrage in Ihrer Anwendung funktioniert.
„Place Details (Legacy)“-Antwort
Antworten für Ortsdetails (Legacy) werden in dem Format zurückgegeben, das durch das Flag output im URL-Pfad der Anfrage angegeben wird.
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": '<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>', "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": [ '<a href="https://maps.google.com/maps/contrib/117600448889234589608">Cynthia Wei</a>', ], "photo_reference": "Aap_uEC6jqtpflLS8GxQqPHBjlcwBf2sri0ZErk9q1ciHGZ6Zx5HBiiiEsPEO3emtB1PGyWbBQhgPL2r9CshoVlJEG4xzB71QMhGBTqqeaCNk1quO3vTTiP50aM1kmOaBQ-DF1ER7zpu6BQOEtnusKMul0m4KA45wfE3h6Xh2IxjLNzx-IiX", "width": 4032, }, { "height": 3264, "html_attributions": [ '<a href="https://maps.google.com/maps/contrib/102493344958625549078">Heyang Li</a>', ], "photo_reference": "Aap_uECyRjHhOQgGaKTW6Z3ZfTEaDhNc44m0F6GrNSFIMffixwI5xqD35QhecdzVY-FUuDtVE1huu8-2HkxgI9Gwvy6W18fU-_E3UUkdSFBQqGK8_slKlT8BZZc66sTX53IEcTDrZfT-E5_YUBYBOm13yxOTOfWfEDABhaxCGC5Hu_XYh0fI", "width": 4912, }, { "height": 3036, "html_attributions": [ '<a href="https://maps.google.com/maps/contrib/104829437842034782235">Anna Linetsky</a>', ], "photo_reference": "Aap_uEAumTzSdhRHDutPAj6wVPSZZmBV-brI6TPFwI0tcQlbSR74z44mUPr4aXMQKck_AzHaKmbfR3P2c1qsu45i1RQPHrcpIXxrA78FmDjCdWYYZWUnFozdcmEj9OQ_V0G08adpKivMKZyeaQ1NuwRy9GhSopeKpzkzkFZG5vXMYPPSgpa1", "width": 4048, }, { "height": 4016, "html_attributions": [ '<a href="https://maps.google.com/maps/contrib/107755640736541028674">Jonah Dell</a>', ], "photo_reference": "Aap_uECC7cSbDkh-TdmXr6m5d5pgVXJmvXg8dF2jzhL0b0Ko4CtnVll6-tIvdz7vhbCsd3hl2u9EgZ4Y30FBxKmFcimfeYUgW2XJyv8JY5IYGuXsKkCLqpV3QH9dIGwoUv2uX0eosDsUsTN2DOlyOasUgVxcYqzIzEmrL5ofIssThQWZeozD", "width": 6016, }, { "height": 3024, "html_attributions": [ '<a href="https://maps.google.com/maps/contrib/115886271727815775491">Anthony Huynh</a>', ], "photo_reference": "Aap_uEDTdw58CglFmZZAR9iZ05x3y2oK9r5_dRqKWnbZKSS9gs6gp9AeBa1QDvBL6dzZyQAZfN8H2Eppu6y4NBaPOp-GkulZYiKRM7Yww8sUEv-8dmcq35Tx38pe4LEX2wIicFkQHedRgMc0FfV9aFtgosQ5ps5-HCjJSApg8eLGyuxxqPm9", "width": 4032, }, { "height": 3024, "html_attributions": [ '<a href="https://maps.google.com/maps/contrib/102939237947063969663">Jasen Baker</a>', ], "photo_reference": "Aap_uEAGqslqZPhZUk0T2Y6l7mkCYnY7JN9li4g5NkZsE0N4Cdy7_cZ-fZWyV02VhpQR4Ph4fLUL6_WTXrlGMXXzUJXUcSmSTs2d_Dzf3Q_A1y07Dm-vtv7pS3JXsWyrWETGIoT1pIj81PPdUc1vlR2i3GFMWAbx9rCC472ZJclY8JlvMg-x", "width": 4032, }, { "height": 3024, "html_attributions": [ '<a href="https://maps.google.com/maps/contrib/100678816592586275978">Jeremy Hsiao</a>', ], "photo_reference": "Aap_uEBaGxeN90YFjD-AUjxZqM44kpMcICKKBBhb0RQQS7DHHFaay8RRAwjWsAt8GEmmB5QnxrbQWHU3TwhVXXHP0m-YNp9Ds3ihpiFan0moNv4QB7kern5cfjWhhrWe8B0dz_vYvmPssJE24P-24YfWWHubOo0L2MjQyueZfDv57N_RvDZk", "width": 4032, }, { "height": 1515, "html_attributions": [ '<a href="https://maps.google.com/maps/contrib/112343109286948028063">Andrew W</a>', ], "photo_reference": "Aap_uEBDzJlmTeNUreMop6_hkC1HKTCRLyPs5fikJi58qCejtkWp5PIM6vzNN3HErkSWUwnamTr_WLyT7jXMAIdByR-hx8dG-OHjj5JxzmcPvuT_VeVLmdSbNPeIlpmp6EUcPOhaVrhEKojSd44QXkl0za29eZ0oj1KDOnAsGxmhanDFW7lI", "width": 2048, }, { "height": 3024, "html_attributions": [ '<a href="https://maps.google.com/maps/contrib/100678816592586275978">Jeremy Hsiao</a>', ], "photo_reference": "Aap_uEBvYFpzCDQzvQ0kdBxxB70lTkLbTM0yH3xF-BCHsb7DQ63cuWnutvwv8oVLDSbA14_kns3WVlEInTyy2elvmH5lzQteb6zzRu3exkwE65_55TgJqdLO7RYYiPFliWk4ocszn9nn5ELv5uP2BQmqr9QET5vwgxR-0eshyVmcdM42jb39", "width": 4032, }, { "height": 4032, "html_attributions": [ '<a href="https://maps.google.com/maps/contrib/100678816592586275978">Jeremy Hsiao</a>', ], "photo_reference": "Aap_uECQynuD_EnSnbz8sJQ6-B6uR-j2tuu4Z1tuGUjq8xnxFDk-W8OdeLzWBX8suNKTCsPlkzTqC22BXf_hX33XclGPL4SS9xnPmHcMrLoUl0H_xHYevFvT17Hgw5DZpSyVmLvDvxzzJ1rsZTh55QwopmAty083a1r1ZIfL32iXh_q8FUas", "width": 3024, }, ], "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": "Called regarding paid advertising google pages to the top of its site of a scam furniture website misleading and taking peoples money without ever sending a product - explained the situation, explained I'd spoken to an ombudsman regarding it. Listed ticket numbers etc.\n\nThey left the advertisement running.", "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": "I need help. Google Australia is taking my money. Money I don't have any I am having trouble sorting this issue out", "time": 1637215605, }, { "author_name": "Jordy Baker", "author_url": "https://www.google.com/maps/contrib/102582237417399865640/reviews", "language": "en", "profile_photo_url": "https://lh3.googleusercontent.com/a/AATXAJwgg1tM4aVA4nJCMjlfJtHtFZuxF475Vb6tT74S=s128-c0x00000000-cc-rp-mo", "rating": 1, "relative_time_description": "4 months ago", "text": "I have literally never been here in my life, I am 17 and they are taking money I don't have for no reason.\n\nThis is not ok. I have rent to pay and my own expenses to deal with and now this.", "time": 1641389490, }, { "author_name": "Prem Rathod", "author_url": "https://www.google.com/maps/contrib/115981614018592114142/reviews", "language": "en", "profile_photo_url": "https://lh3.googleusercontent.com/a/AATXAJyEQpqs4YvPPzMPG2dnnRTFPC4jxJfn8YXnm2gz=s128-c0x00000000-cc-rp-mo", "rating": 1, "relative_time_description": "4 months ago", "text": "Terrible service. all reviews are fake and irrelevant. This is about reviewing google as business not the building/staff etc.", "time": 1640159655, }, { "author_name": "Husuni Hamza", "author_url": "https://www.google.com/maps/contrib/102167316656574288776/reviews", "language": "en", "profile_photo_url": "https://lh3.googleusercontent.com/a/AATXAJwRkyvoSlgd06ahkF9XI9D39o6Zc_Oycm5EKuRg=s128-c0x00000000-cc-rp-mo", "rating": 5, "relative_time_description": "7 months ago", "text": "Nice site. Please I want to work with you. Am Alhassan Haruna, from Ghana. Contact me +233553851616", "time": 1633197305, }, ], "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
<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>Called regarding paid advertising google pages to the top of its site of a scam furniture website misleading and taking peoples money without ever sending a product - explained the situation, explained I'd spoken to an ombudsman regarding it. Listed ticket numbers etc. They left the advertisement running.</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>I need help. Google Australia is taking my money. Money I don't have any I am having trouble sorting this issue out</text> <author_name>Tevita Taufoou</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> <review> <time>1641389490</time> <text>I have literally never been here in my life, I am 17 and they are taking money I don't have for no reason. This is not ok. I have rent to pay and my own expenses to deal with and now this.</text> <author_name>Jordy Baker</author_name> <author_url>https://www.google.com/maps/contrib/102582237417399865640/reviews</author_url> <rating>1.0</rating> <language>en</language> <profile_photo_url>https://lh3.googleusercontent.com/a/AATXAJwgg1tM4aVA4nJCMjlfJtHtFZuxF475Vb6tT74S=s128-c0x00000000-cc-rp-mo</profile_photo_url> <relative_time_description>4 months ago</relative_time_description> </review> <review> <time>1640159655</time> <text>Terrible service. all reviews are fake and irrelevant. This is about reviewing google as business not the building/staff etc.</text> <author_name>Prem Rathod</author_name> <author_url>https://www.google.com/maps/contrib/115981614018592114142/reviews</author_url> <rating>1.0</rating> <language>en</language> <profile_photo_url>https://lh3.googleusercontent.com/a/AATXAJyEQpqs4YvPPzMPG2dnnRTFPC4jxJfn8YXnm2gz=s128-c0x00000000-cc-rp-mo</profile_photo_url> <relative_time_description>4 months ago</relative_time_description> </review> <review> <time>1633197305</time> <text>Nice site. Please I want to work with you. Am Alhassan Haruna, from Ghana. Contact me +233553851616</text> <author_name>Husuni Hamza</author_name> <author_url>https://www.google.com/maps/contrib/102167316656574288776/reviews</author_url> <rating>5.0</rating> <language>en</language> <profile_photo_url>https://lh3.googleusercontent.com/a/AATXAJwRkyvoSlgd06ahkF9XI9D39o6Zc_Oycm5EKuRg=s128-c0x00000000-cc-rp-mo</profile_photo_url> <relative_time_description>7 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> <photo> <photo_reference>Aap_uEBXOmqXNblj10HJavekmUNyUwccggfNN9KVE9TjYcU9HXkBHdvnwfYHDx3dfrjJJwnN8yooP-5412iJNRk8cwUbAVYbD2326cfiJJ3oK6pOrAi1oBmCYuAwKTHnX3EQvSbheVhJZPNDHlT5TjKcwfwAb80eyLB2UNyWl3Y6D7YS7ZSf</photo_reference> <width>4048</width> <height>3036</height> <html_attribution><a href="https://maps.google.com/maps/contrib/104829437842034782235">Anna Linetsky</a></html_attribution> </photo> <photo> <photo_reference>Aap_uEAWyGsK1fp3SE73xICq8FJNlrVVqRk8E6YfMiz-o8IJj1vESmuDj4NnPDP4S2kWFrfoBpqw9lmXBGxtYo6nPMySfBAcRIbdEg0ko4dcdzsBvo6cRUz9XpmlcoptCpIAKEb6f7Bh_OD0zFntYbTz-pLdQ9ZHB8tBvTb3kzfTdK2Du0yC</photo_reference> <width>6016</width> <height>4016</height> <html_attribution><a href="https://maps.google.com/maps/contrib/107755640736541028674">Jonah Dell</a></html_attribution> </photo> <photo> <photo_reference>Aap_uEAxbn61tx1hwCo3kUMd2KPlWaBkrFhXHxsZDgkYxpJqc-ZYC6U0MH6urfbHVrwmMoosOG0G39anmR68B7p2Up3AACxTa21vCopSL6-RHIphVsBhfhOrFMlGNqBDEsnmY15X0FzzNMKASXqmqtzBphiRyGhAFKfRs3Js1ymXP_FWjqzT</photo_reference> <width>4032</width> <height>3024</height> <html_attribution><a href="https://maps.google.com/maps/contrib/115886271727815775491">Anthony Huynh</a></html_attribution> </photo> <photo> <photo_reference>Aap_uEClwnjuvgS58OknaXxZeVGf5ydyG6U6lO9srr8FU7tPoZ4DvqQo-GUeemssC11tzDBUMWit4ILWF-GmlRfIHS8FuAtttOgp2wvgPhs-ADUrznLRXYKBRkNQnRLEIA1PBgJN9Eev8tFWxpY_jBMklkEUZJRjm-mk9R0bSKSelpPgMYAz</photo_reference> <width>4032</width> <height>3024</height> <html_attribution><a href="https://maps.google.com/maps/contrib/102939237947063969663">Jasen Baker</a></html_attribution> </photo> <photo> <photo_reference>Aap_uEBvISYtwjSgTQntTJJ_-XhPUF4CVCQF3wxM0FjcQJuzomYLfZWFlIWsOgXhwt2Sd8K6OqFrSP8XHHrBaqQJHD-om-H_wfRLVmiAoQa8QG5oxt540AucTMP4H2QfhTXngqEoNuOcbb-xo2l01OPUetTdIZQ3S6U5s2iyGrHpTs3qz8CH</photo_reference> <width>4032</width> <height>3024</height> <html_attribution><a href="https://maps.google.com/maps/contrib/100678816592586275978">Jeremy Hsiao</a></html_attribution> </photo> <photo> <photo_reference>Aap_uEB2cYxbKE7uIXQ_IhX3TvZHDcFHXjWSwezoiwP3eWlfIDTWwq3xtsYZY7QSrhR2d9s1eWmZlM5zr9iHlC_n0gsJXNeRcfd2JjuLFaNuC7VfpeIsdQchhOybG0drJ2CxzD187Az-Foip-6MutDA22LINPw0Iyc_yT04WbxQDxhiwu2Cn</photo_reference> <width>2048</width> <height>1515</height> <html_attribution><a href="https://maps.google.com/maps/contrib/112343109286948028063">Andrew W</a></html_attribution> </photo> <photo> <photo_reference>Aap_uEBJyLgeilgow1JnoKW83IBsl8CPkmryN8nGYtBzzLaiLjFicWxC1YPQusM-_Fvfb1bkbuShrzjXmHCOp5HoBgJsgit8o0HPYWgjSwrdySqde1BgfKbwS-TWbPg_dwTnVR8LrVPxa_vpLzNlx1b-WpDZo3-_KvxH2GARhVrcvWkvMYD0</photo_reference> <width>4032</width> <height>3024</height> <html_attribution><a href="https://maps.google.com/maps/contrib/100678816592586275978">Jeremy Hsiao</a></html_attribution> </photo> <photo> <photo_reference>Aap_uEADyMSxLevgbLWCJeHA8kIN3w6-JcndbuHvTB0oqR-IlWbml4bbYmR-_iYU15HBh8xi3w5hZ455pda6m-BlLCscr6g_Zc5FmBOHW56IsZF3Pxif5UmeGZSsg3WIjHCoL-JyndN0nkfyzS31E05tZi61RfXQ2UPY2_5ceKYua5U6d5Zd</photo_reference> <width>3024</width> <height>4032</height> <html_attribution><a href="https://maps.google.com/maps/contrib/100678816592586275978">Jeremy Hsiao</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 die folgenden Elemente:
PlacesDetailsResponse
| Field | Required | Type | Description |
|---|---|---|---|
| required | Array<string> | May contain a set of attributions about this listing which must be displayed to the user (some listings may not have attribution). |
| required | Place | Contains the detailed information about the place requested. See Place for more information. |
| required | PlacesDetailsStatus | Contains the status of the request, and may contain debugging information to help you track down why the request failed. See PlacesDetailsStatus for more information. |
| optional | Array<string> |
When the service returns additional information about the request
specification, there may be an additional
|
In einer JSON-Antwort werden sie als Stammelemente dargestellt. In einer XML-Antwort werden diese als Elemente der obersten Ebene unter <PlaceDetailsResponse> angezeigt.
PlacesDetailsStatus
Status codes returned by service.
OKindicating the API request was successful.ZERO_RESULTSindicating that the referenced location,place_id, was valid but no longer refers to a valid result. This may occur if the establishment is no longer in business.NOT_FOUNDindicating that that the referenced location,place_id, was not found in the Places database.INVALID_REQUESTindicating the API request was malformed.OVER_QUERY_LIMITindicating any of the following:- You have exceeded the QPS limits.
- Billing has not been enabled on your account.
- The monthly $200 credit, or a self-imposed usage cap, has been exceeded.
- The provided method of payment is no longer valid (for example, a credit card has expired).
REQUEST_DENIEDindicating that your request was denied, generally because:- The request is missing an API key.
- The
keyparameter is invalid.
UNKNOWN_ERRORindicating an unknown error.
Place
Attributes describing a place. Not all attributes will be available for all place types.
| Field | Required | Type | Description |
|---|---|---|---|
| optional | Array<AddressComponent> | An array containing the separate components applicable to this address. See AddressComponent for more information. |
| optional | string | A representation of the place's address in the adr microformat. |
| optional | string |
Indicates the operational status of the place, if it is a business.
If no data exists,
The allowed values include: OPERATIONAL,
CLOSED_TEMPORARILY, and CLOSED_PERMANENTLY |
| optional | boolean | Specifies if the business supports curbside pickup. |
| optional | PlaceOpeningHours |
Contains the hours of operation for the next seven days (including
today). The time period starts at midnight on the date of the
request and ends at 11:59 pm six days later. This field includes the
See PlaceOpeningHours for more information. |
| optional | boolean | Specifies if the business supports delivery. |
| optional | boolean | Specifies if the business supports indoor or outdoor seating options. |
| optional | PlaceEditorialSummary | Contains a summary of the place. A summary is comprised of a textual overview, and also includes the language code for these if applicable. Summary text must be presented as-is and can not be modified or altered. See PlaceEditorialSummary for more information. |
| optional | string | A string containing the human-readable address of this place. Often this address is equivalent to the postal address. Note that some countries, such as the United Kingdom, do not allow distribution of true postal addresses due to licensing restrictions. The formatted address is logically composed of one or more address components. For example, the address "111 8th Avenue, New York, NY" consists of the following components: "111" (the street number), "8th Avenue" (the route), "New York" (the city) and "NY" (the US state). Do not parse the formatted address programmatically. Instead you should use the individual address components, which the API response includes in addition to the formatted address field. |
| optional | string | Contains the place's phone number in its local format. |
| optional | Geometry | Contains the location and viewport for the location. See Geometry for more information. |
| optional | string | Contains the URL of a suggested icon which may be displayed to the user when indicating this result on a map. |
| optional | string | Contains the default HEX color code for the place's category. |
| optional | string |
Contains the URL of a recommended icon, minus the
|
| optional | string |
Contains the place's phone number in international format.
International format includes the country code, and is prefixed with
the plus, +, sign. For example, the international_phone_number for
Google's Sydney, Australia office is |
| optional | string |
Contains the human-readable name for the returned result. For
|
| optional | PlaceOpeningHours | Contains the regular hours of operation. See PlaceOpeningHours for more information. |
| optional | boolean |
Use |
| optional | Array<PlacePhoto> | An array of photo objects, each containing a reference to an image. A request may return up to ten photos. More information about place photos and how you can use the images in your application can be found in the Place Photos documentation. See PlacePhoto for more information. |
| optional | string |
A textual identifier that uniquely identifies a place. To retrieve
information about the place, pass this identifier in the
|
| optional | PlusCode | An encoded location reference, derived from latitude and longitude coordinates, that represents an area: 1/8000th of a degree by 1/8000th of a degree (about 14m x 14m at the equator) or smaller. Plus codes can be used as a replacement for street addresses in places where they do not exist (where buildings are not numbered or streets are not named). See Open Location Code and plus codes. See PlusCode for more information. |
| optional | number | The price level of the place, on a scale of 0 to 4. The exact amount indicated by a specific value will vary from region to region. Price levels are interpreted as follows:
|
| optional | number | Contains the place's rating, from 1.0 to 5.0, based on aggregated user reviews. |
| optional | string | |
| optional | boolean | Specifies if the place supports reservations. |
| optional | Array<PlaceReview> |
A JSON array of up to five reviews. By default, the reviews are
sorted in order of relevance. Use the
Google recommends indicating to users whether results are ordered by
See PlaceReview for more information. |
| optional | string | |
| optional | Array<PlaceOpeningHours> |
Contains an array of entries for the next seven days including
information about secondary hours of a business. Secondary hours are
different from a business's main hours. For example, a restaurant
can specify drive through hours or delivery hours as its secondary
hours. This field populates the See PlaceOpeningHours for more information. |
| optional | boolean | Specifies if the place serves beer. |
| optional | boolean | Specifies if the place serves breakfast. |
| optional | boolean | Specifies if the place serves brunch. |
| optional | boolean | Specifies if the place serves dinner. |
| optional | boolean | Specifies if the place serves lunch. |
| optional | boolean | Specifies if the place serves vegetarian food. |
| optional | boolean | Specifies if the place serves wine. |
| optional | boolean | Specifies if the business supports takeout. |
| optional | Array<string> | Contains an array of feature types describing the given result. See the list of supported types. |
| optional | string | Contains the URL of the official Google page for this place. This will be the Google-owned page that contains the best available information about the place. Applications must link to or embed this page on any screen that shows detailed results about the place to the user. |
| optional | number | The total number of reviews, with or without text, for this place. |
| optional | number | Contains the number of minutes this place’s current timezone is offset from UTC. For example, for places in Sydney, Australia during daylight saving time this would be 660 (+11 hours from UTC), and for places in California outside of daylight saving time this would be -480 (-8 hours from UTC). |
| optional | string |
For establishment (
For all other results, the This content is meant to be read as-is. Do not programmatically parse the formatted address. |
| optional | string | The authoritative website for this place, such as a business' homepage. |
| optional | boolean | Specifies if the place has an entrance that is wheelchair-accessible. |
AddressComponent
| Field | Required | Type | Description |
|---|---|---|---|
| required | string | The full text description or name of the address component as returned by the Geocoder. |
| required | string | An abbreviated textual name for the address component, if available. For example, an address component for the state of Alaska may have a long_name of "Alaska" and a short_name of "AK" using the 2-letter postal abbreviation. |
| required | Array<string> | An array indicating the type of the address component. See the list of supported types. |
PlaceEditorialSummary
Contains a summary of the place. A summary is comprised of a textual overview, and also includes the language code for these if applicable. Summary text must be presented as-is and can not be modified or altered.
| Field | Required | Type | Description |
|---|---|---|---|
| optional | string | The language of the previous fields. May not always be present. |
| optional | string | A medium-length textual summary of the place. |
Geometry
An object describing the location.
| Field | Required | Type | Description |
|---|---|---|---|
| required | LatLngLiteral | See LatLngLiteral for more information. |
| required | Bounds | See Bounds for more information. |
LatLngLiteral
An object describing a specific location with Latitude and Longitude in decimal degrees.
| Field | Required | Type | Description |
|---|---|---|---|
| required | number | Latitude in decimal degrees |
| required | number | Longitude in decimal degrees |
Bounds
A rectangle in geographical coordinates from points at the southwest and northeast corners.
| Field | Required | Type | Description |
|---|---|---|---|
| required | LatLngLiteral | See LatLngLiteral for more information. |
| required | LatLngLiteral | See LatLngLiteral for more information. |
PlaceOpeningHours
An object describing the opening hours of a place.
| Field | Required | Type | Description |
|---|---|---|---|
| optional | boolean | A boolean value indicating if the place is open at the current time. |
| optional | Array<PlaceOpeningHoursPeriod> | An array of opening periods covering seven days, starting from Sunday, in chronological order. See PlaceOpeningHoursPeriod for more information. |
| optional | Array<PlaceSpecialDay> | An array of up to seven entries corresponding to the next seven days. See PlaceSpecialDay for more information. |
| optional | string |
A type string used to identify the type of secondary hours (for
example, |
| optional | Array<string> | An array of strings describing in human-readable text the hours of the place. |
PlaceOpeningHoursPeriod
| Field | Required | Type | Description |
|---|---|---|---|
| required | PlaceOpeningHoursPeriodDetail | Contains a pair of day and time objects describing when the place opens. See PlaceOpeningHoursPeriodDetail for more information. |
| optional | PlaceOpeningHoursPeriodDetail |
May contain a pair of day and time objects describing when the place
closes. If a place is always open, the close section will be missing
from the response. Clients can rely on always-open being represented
as an open period containing day with value See PlaceOpeningHoursPeriodDetail for more information. |
PlaceSpecialDay
| Field | Required | Type | Description |
|---|---|---|---|
| optional | string | A date expressed in RFC3339 format in the local timezone for the place, for example 2010-12-31. |
| optional | boolean |
True if there are exceptional hours for this day. If
|
PlaceOpeningHoursPeriodDetail
| Field | Required | Type | Description |
|---|---|---|---|
| required | number | A number from 0–6, corresponding to the days of the week, starting on Sunday. For example, 2 means Tuesday. |
| required | string | May contain a time of day in 24-hour hhmm format. Values are in the range 0000–2359. The time will be reported in the place’s time zone. |
| optional | string | A date expressed in RFC3339 format in the local timezone for the place, for example 2010-12-31. |
| optional | boolean | True if a given period was truncated due to a seven-day cutoff, where the period starts before midnight on the date of the request and/or ends at or after midnight on the last day. This property indicates that the period for open or close can extend past this seven-day cutoff. |
PlacePhoto
A photo of a Place. The photo can be accesed via the Place Photo API using an url in the following pattern:
https://maps.googleapis.com/maps/api/place/photo?maxwidth=400&photo_reference=photo_reference&key=YOUR_API_KEY
See Place Photos for more information.
| Field | Required | Type | Description |
|---|---|---|---|
| required | number | The height of the photo. |
| required | Array<string> | The HTML attributions for the photo. |
| required | string | A string used to identify the photo when you perform a Photo request. |
| required | number | The width of the photo. |
PlusCode
An encoded location reference, derived from latitude and longitude coordinates, that represents an area, 1/8000th of a degree by 1/8000th of a degree (about 14m x 14m at the equator) or smaller. Plus codes can be used as a replacement for street addresses in places where they do not exist (where buildings are not numbered or streets are not named).
| Field | Required | Type | Description |
|---|---|---|---|
| required | string |
The |
| optional | string |
The |
PlaceReview
A review of the place submitted by a user.
| Field | Required | Type | Description |
|---|---|---|---|
| required | string | The name of the user who submitted the review. Anonymous reviews are attributed to "A Google user". |
| required | number | The user's overall rating for this place. This is a whole number, ranging from 1 to 5. |
| required | string | The time that the review was submitted in text, relative to the current time. |
| required | number | The time that the review was submitted, measured in the number of seconds since since midnight, January 1, 1970 UTC. |
| optional | string | The URL to the user's Google Maps Local Guides profile, if available. |
| optional | string | An IETF language code indicating the language of the returned review.This field contains the main language tag only, and not the secondary tag indicating country or region. For example, all the English reviews are tagged as 'en', and not 'en-AU' or 'en-UK' and so on.This field is empty if there is only a rating with no review text. |
| optional | string |
An IETF language code indicating the original language of the
review. If the review has been translated, then
|
| optional | string | The URL to the user's profile photo, if available. |
| optional | string |
The user's review. When reviewing a location with Google Places,
text reviews are considered optional. Therefore, this field may be
empty. Note that this field may include simple HTML markup. For
example, the entity reference |
| optional | boolean | A boolean value indicating if the review was translated from the original language it was written in.If a review has been translated, corresponding to a value of true, Google recommends that you indicate this to your users. For example, you can add the following string, “Translated by Google”, to the review. |