Ortsdetails (neu)

Plattform auswählen: Android iOS JavaScript Webdienst

Sobald Sie eine Orts-ID haben, können Sie weitere Details zu einer bestimmten Einrichtung oder indem Sie eine Place Details (neu) A Place Details (Neu) -Anforderung gibt umfassendere Informationen zum angegebenen Ort zurück. etwa die vollständige Adresse, Telefonnummer, Nutzerbewertungen und Rezensionen.

Es gibt viele Möglichkeiten, eine Orts-ID zu erhalten. Sie können Folgendes angeben:

Mit dem API Explorer können Sie Live-Anfragen stellen, damit Sie sich mit der API und den API-Optionen:

Testen!

„Place Details (New)“-Anfragen

Eine „Place Details“-Anfrage ist eine HTTP GET-Anfrage im Format:

https://places.googleapis.com/v1/places/PLACE_ID

Übergeben Sie alle Parameter als URL-Parameter oder in Headern als Teil des GET-Anfrage. Beispiel:

https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw?fields=id,displayName&key=API_KEY

Oder in einem cURL-Befehl:

curl -X GET -H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: id,displayName" \
https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw

„Place Details (New)“-Antworten

„Place Details (New)“ gibt eine <ph type="x-smartling-placeholder"></ph> JSON-Objekt als Antwort an. In der Antwort:

  • Die Antwort wird durch eine Place -Objekt enthält. Das Objekt Place enthält detaillierte Informationen zum
  • Die in der Anfrage übergebene FieldMask gibt die Liste der Felder an. wird im Place-Objekt zurückgegeben.

Das vollständige JSON-Objekt hat das folgende Format:

{
  "name": "places/ChIJkR8FdQNB0VQRm64T_lv1g1g",
  "id": "ChIJkR8FdQNB0VQRm64T_lv1g1g",
  "displayName": {
    "text": "Trinidad"
  }
  ...
}

Erforderliche Parameter

  • FieldMask

    Geben Sie die Liste der Felder an, die in der Antwort zurückgegeben werden sollen, indem Sie ein Antwortfeldmaske. Übergeben Sie die Antwortfeldmaske mithilfe des URL-Parameters an die Methode. $fields oder fields oder mithilfe des HTTP-Headers X-Goog-FieldMask Die Antwort enthält keine Standardliste mit zurückgegebenen Feldern. Wenn Sie die Feldmaske weglassen, gibt die Methode einen Fehler zurück.

    Die Maskierung von Feldern ist sinnvoll, um unnötige Daten zu verarbeiten, um unnötige Verarbeitungszeiten zu vermeiden Abrechnungsgebühren.

    Geben Sie eine durch Kommas getrennte Liste der Ortsdatentypen an, die zurückgegeben werden sollen. Beispiel: um den Anzeigenamen und die Adresse des Orts abzurufen.

    X-Goog-FieldMask: displayName,formattedAddress

    Verwenden Sie *, um alle Felder abzurufen.

    X-Goog-FieldMask: *

    Geben Sie eines oder mehrere der folgenden Felder an:

    • Die folgenden Felder lösen die SKU „Place Details (IDs Only)“ aus:

      attributions, id, name* photos

      * Das Feld name enthält den Ressourcennamen des Orts. im Format places/PLACE_ID. Verwenden Sie displayName, um auf den Textnamen des Orts zuzugreifen.

    • Die folgenden Felder lösen die SKU „Place Details (Location Only)“ aus:

      addressComponents, adrFormatAddress, formattedAddress, location, plusCode, shortFormattedAddress, types, viewport

    • Die folgenden Felder lösen die SKU Place Details (Basic) aus:

      accessibilityOptions, businessStatus, displayName, googleMapsUri, iconBackgroundColor, iconMaskBaseUri, primaryType, primaryTypeDisplayName, subDestinations, utcOffsetMinutes

    • Die folgenden Felder lösen die SKU Place Details (Advanced) aus:

      currentOpeningHours, currentSecondaryOpeningHours, internationalPhoneNumber, nationalPhoneNumber, priceLevel, rating, regularOpeningHours, regularSecondaryOpeningHours, userRatingCount, websiteUri

    • Die folgenden Felder lösen die SKU Place Details (Preferred) aus:

      allowsDogs, curbsidePickup, delivery, dineIn, editorialSummary, evChargeOptions, fuelOptions, goodForChildren, goodForGroups, goodForWatchingSports, liveMusic, menuForChildren, parkingOptions, paymentOptions, outdoorSeating, reservable, restroom, reviews, servesBeer, servesBreakfast, servesBrunch, servesCocktails, servesCoffee, servesDessert, servesDinner, servesLunch, servesVegetarianFood, servesWine, takeout

  • placeId

    Eine ID in Textform, die einen Ort eindeutig identifiziert. Sie wird von einem Text Search (New) oder Nearby Search (Neu). Weitere Informationen zu Orts-IDs finden Sie in der Orts-ID-Übersicht.

    Der String places/PLACE_ID wird auch als Ort bezeichnet. Ressourcenname. In der Antwort von „Place Details (New)“ Nearby Search (New) und Text Search (New) angegeben ist, ist dieser String im Feld name der Antwort enthalten. Die eigenständige Version Die Orts-ID ist im Feld id der Antwort enthalten.

Optionale Parameter

  • languageCode

    Die Sprache, in der die Ergebnisse zurückgegeben werden sollen.

    • Weitere Informationen finden Sie in der Liste der unterstützten Sprachen. Google aktualisiert häufig unterstützten Sprachen, daher ist diese Liste möglicherweise nicht vollständig.
    • Wenn languageCode nicht angegeben ist, wird standardmäßig en verwendet. Wenn Sie einen ungültigen Sprachcode angeben, gibt die API den Fehler INVALID_ARGUMENT zurück.
    • Die API versucht möglichst, eine Adresse bereitzustellen, die für sowohl für Nutzer als auch für Ortsansässige. Um dieses Ziel zu erreichen, gibt er Adressen in der Landessprache, in ein Skript umgewandelt, das von wenn nötig, unter Berücksichtigung der bevorzugten Sprache. Alle anderen Adressen werden in der bevorzugten Sprache zurückgegeben. Adresskomponenten sind alle in derselben Sprache zurückgegeben, die aus der ersten Komponente.
    • Wenn ein Name in der bevorzugten Sprache nicht verfügbar ist, verwendet die API den am genauesten übereinstimmen.
    • Die bevorzugte Sprache hat einen geringen Einfluss auf die Suchergebnisse, und in welcher Reihenfolge sie zurückgegeben werden. Die Der Geocoder interpretiert Abkürzungen je nach Sprache unterschiedlich, etwa die Abkürzungen für Straßentypen oder Synonyme, die möglicherweise in einer Sprache gültig sind, aber nicht in einer anderen.

  • regionCode

    Der Regionscode, der zum Formatieren der Antwort verwendet wird, angegeben als <ph type="x-smartling-placeholder"></ph> zweistelligen CLDR-Code eingeben. Es gibt keinen Standardwert.

    Wenn der Ländername des Felds formattedAddress in der Antwort mit dem regionCode wird der Ländercode bei formattedAddress weggelassen. Dieser Parameter hat keine Auswirkungen auf adrFormatAddress. Dazu gehören immer das Land Name oder auf shortFormattedAddress, wo ihn nie enthalten ist.

    Die meisten CLDR-Codes entsprechen den ISO 3166-1-Codes, mit einigen nennenswerten Ausnahmen. Die ccTLD des Vereinigten Königreichs lautet beispielsweise „uk“ (.co.uk), während der ISO 3166-1-Code „gb“ lautet (technisch für die Rechtspersönlichkeit des Vereinigten Königreichs Großbritannien und Nordirland“). Der Parameter kann sich gemäß geltendem Recht auf Ergebnisse auswirken.

  • sessionToken

    Sitzungstokens sind vom Nutzer erstellte Strings, die die automatische Vervollständigung erfassen (Neu) Aufrufe als „Sitzungen“. Bei Autocomplete (New) werden Sitzungstokens verwendet, um Die Phasen „Abfrage“ und „Ortsauswahl“ einer Suche mit automatischer Vervollständigung durch Nutzer in einer separaten Sitzung gruppieren zu Abrechnungszwecken. Sitzungstokens werden an „Place Details (New)“ übergeben Aufrufe, die auf „Autocomplete“-Aufrufe („Neu“) folgen. Weitere Informationen finden Sie unter Sitzungstokens

Beispiel für „Place Details“

Im folgenden Beispiel werden die Details eines Ortes placeId:

curl -X GET -H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: id,displayName" \
https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw

Der X-Goog-FieldMask-Header gibt an, dass die Antwort enthält die folgenden Datenfelder: id,displayName. Die Antwort hat dann folgendes Format:

{
  "id": "ChIJj61dQgK6j4AR4GeTYWZsKWw",
  "displayName": {
    "text": "Googleplex",
    "languageCode": "en"
  }
}

Fügen Sie der Feldmaske weitere Datentypen hinzu, um zusätzliche Informationen zurückzugeben. Fügen Sie beispielsweise formattedAddress,plusCode hinzu, um den Parameter und Plus Code in das Feld Antwort:

curl -X GET -H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: id,displayName,formattedAddress,plusCode" \
https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw

Die Antwort hat nun das folgende Format:

{
  "id": "ChIJj61dQgK6j4AR4GeTYWZsKWw",
  "formattedAddress": "1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA",
  "plusCode": {
    "globalCode": "849VCWC7+RW",
    "compoundCode": "CWC7+RW Mountain View, CA, USA"
  },
  "displayName": {
    "text": "Googleplex",
    "languageCode": "en"
  }
}

Testen!

Mit dem API Explorer können Sie Beispielanfragen stellen, damit Sie sich mit der API und den API-Optionen vertraut machen können.

So stellen Sie eine Anfrage:

  1. Klicken Sie auf das API-Symbol Maximieren Sie API Explorer.. rechts auf der Seite.
  2. Optional können Sie den Parameter name auf Folgendes festlegen: 
    places/PLACE_ID
  3. Erweitern Sie optional Standardparameter anzeigen und legen Sie Parameter fields zur Feldmaske hinzu.
  4. Klicken Sie auf die Schaltfläche Execute (Ausführen). Wählen Sie im Pop-up-Fenster das Konto aus, verwenden, um die Anfrage zu stellen.

  5. Klicken Sie im API Explorer auf das Symbol zum Maximieren Maximieren Sie API Explorer., um das API Explorer-Fenster zu maximieren.