Place Details (Legacy)

Entwickler im Europäischen Wirtschaftsraum (EWR)

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.
  • xml gibt 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

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) eine place_id abrufen 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, website

    Atmosphere

    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 language nicht angegeben ist, versucht die API, die im Header Accept-Language angegebene 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=true an, um die Übersetzung von Rezensionen zu deaktivieren. Geben Sie reviews_no_translations=false an, 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 language in der Anfrage angegeben wurde, wird die angegebene Sprache als bevorzugte Sprache für die Übersetzung verwendet. Wenn language weggelassen wird, versucht die API, den Header Accept-Language als bevorzugte Sprache zu verwenden.

  • reviews_sort

    Die Sortiermethode, die beim Zurückgeben von Rezensionen verwendet werden soll. Kann auf most_relevant (Standard) oder newest festgelegt werden.

    • Bei most_relevant (Standard) werden Rezensionen nach Relevanz sortiert. Der Dienst bevorzugt Ergebnisse, die ursprünglich in der bevorzugten Sprache verfasst wurden.
    • Bei newest werden Rezensionen in chronologischer Reihenfolge sortiert. Die bevorzugte Sprache hat keinen Einfluss auf die Sortierreihenfolge.

    Google empfiehlt, dem Endnutzer anzuzeigen, wie die Rezensionen sortiert werden.

  • 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>&lt;a href=&quot;https://maps.google.com/maps/contrib/117600448889234589608&quot;&gt;Cynthia Wei&lt;/a&gt;</html_attribution>
  </photo>
  <photo>
   <photo_reference>Aap_uEAPNVkxDxxHa0aRFAkA2gMygFUuaKujSSv-zdad_vuaxTkaDHgX-aVPeNATp7VEgwqa3A3QutoeKdDd6aGZPBPCLl8XTf1vYckEBxIWEXZjFlMXK2TwIVfe4qa6O31AbYQQ5TCrEs9nz2fuBBWJwifTiKIIrv4NrEpQok6i8nnn8xKS</photo_reference>
   <width>4912</width>
   <height>3264</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/102493344958625549078&quot;&gt;Heyang Li&lt;/a&gt;</html_attribution>
  </photo>
  <!-- ... -->
  <adr_address>&lt;span class=&quot;street-address&quot;&gt;48 Pirrama Rd&lt;/span&gt;, &lt;span class=&quot;locality&quot;&gt;Pyrmont&lt;/span&gt; &lt;span class=&quot;region&quot;&gt;NSW&lt;/span&gt; &lt;span class=&quot;postal-code&quot;&gt;2009&lt;/span&gt;, &lt;span class=&quot;country-name&quot;&gt;Australia&lt;/span&gt;</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 info_messages-Feld enthalten. Dieses Feld wird nur für erfolgreiche Anfragen zurückgegeben. Sie wird möglicherweise nicht immer zurückgegeben und ihr Inhalt kann sich ändern.

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 Ort place_id war 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.
    Weitere Informationen zur Behebung dieses Fehlers finden Sie in den FAQs zu Maps.
  • REQUEST_DENIED gibt an, dass Ihre Anfrage abgelehnt wurde, im Allgemeinen aus folgenden Gründen:
    • In der Anfrage fehlt ein API-Schlüssel.
    • Der Parameter key ist 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 AddressComponent.

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 business_status kein Wert zurückgegeben.

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 special_days aller Öffnungszeiten, die für Datumsangaben mit Sonderöffnungszeiten festgelegt sind.

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 Geometry.

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 .svg oder .png.

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. +61 2 9374 4000.

optional String

Enthält den menschenlesbaren Namen für das zurückgegebene Ergebnis. Bei establishment-Ergebnissen ist dies normalerweise der kanonische Name des Unternehmens.

optional PlaceOpeningHours

Enthält die regulären Öffnungszeiten.

Weitere Informationen finden Sie unter PlaceOpeningHours.

optional boolean

Nutzen Sie business_status, um den Öffnungsstatus von Unternehmen abzurufen.

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 place_id einer Places API-Anfrage, um Informationen zum Ort abzurufen. Weitere Informationen finden Sie in der Übersicht zur Orts-ID.

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 PlusCode.

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:

  • 0 €
  • 1 Günstig
  • 2 Mittel
  • 3 Teuer
  • 4 Sehr teuer
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 reviews_sort, um die Sortierung zu steuern.

  • Bei most_relevant (Standard) werden Rezensionen nach Relevanz sortiert. Der Dienst bevorzugt Ergebnisse, die ursprünglich in der bevorzugten Sprache verfasst wurden.
  • Bei newest werden Rezensionen in chronologischer Reihenfolge sortiert. Die bevorzugte Sprache hat keinen Einfluss auf die Sortierreihenfolge.

Google empfiehlt, Nutzern anzuzeigen, ob die Ergebnisse nach most_relevant oder newest sortiert sind.

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 type ausgefüllt, das auf einer vordefinierten Liste von Öffnungszeitentypen (z. B. DRIVE_THROUGH, PICKUP oder TAKEOUT) basiert, die sich nach den Typen des Ortes richten. Dieses Feld enthält das Unterfeld special_days aller Öffnungszeiten, die für Datumsangaben mit Sonderöffnungszeiten festgelegt sind.

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 (types:["establishment", ...])) enthält das Feld vicinity eine vereinfachte Adresse des Ortes, einschließlich Straße, Hausnummer und Verwaltungseinheit, aber ohne Provinz/Bundesland, Postleitzahl oder Land.

Bei allen anderen Ergebnissen enthält das Feld vicinity den Namen des kleinsten politischen (types:["political", ...]) Elements, das in der Adresse des Ergebnisses vorhanden ist.

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. DRIVE_THROUGH, HAPPY_HOUR, DELIVERY, TAKEOUT, KITCHEN, BREAKFAST, LUNCH, DINNER, BRUNCH, PICKUP, SENIOR_HOURS). Nur für secondary_opening_hours festgelegt.

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 0 und „time“ mit dem Wert 0000 dargestellt. close ist dann nicht vorhanden.

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 true, bedeutet dies, dass es für diesen Tag mindestens eine Ausnahme gibt. Ausnahmen führen dazu, dass in den Unterfeldern von current_opening_hours und secondary_opening_hours unterschiedliche Werte auftreten, z. B. periods, weekday_text, open_now. Die Ausnahmen gelten für die Stunden und die Stunden werden verwendet, um die anderen Felder zu generieren.

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 original_language != language.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

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 &amp; ein kaufmännisches Und-Zeichen darstellen.

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“.