Method: places.get

Sie können die Details eines Orts anhand seines Ressourcennamens abrufen. Dieser ist ein String im Format places/{placeId}.

HTTP-Anfrage

GET https://places.googleapis.com/v1/{name=places/*}

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
name

string

Erforderlich. Der Ressourcenname eines Orts im Format places/{placeId}.

Abfrageparameter

Parameter
languageCode

string

Optional. Details zum Ort werden in der bevorzugten Sprache angezeigt, sofern verfügbar.

Aktuelle Liste der unterstützten Sprachen: https://developers.google.com/maps/faq#languagesupport
regionCode

string

Optional. Der Unicode-Länder-/Regionscode (CLDR) des Standorts, von dem die Anfrage stammt. Mit diesem Parameter werden Ortsdetails wie der regionsspezifische Ortsname (sofern verfügbar) angezeigt. Der Parameter kann sich auf die Ergebnisse auswirken, die gemäß anwendbarem Recht angezeigt werden. Weitere Informationen finden Sie unter https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html.

Dreistellige Regionscodes werden derzeit nicht unterstützt.
sessionToken

string

Optional. Ein String, der eine Autocomplete-Sitzung zu Abrechnungszwecken identifiziert. Muss ein URL- und Dateinamen-sicherer Base64-String mit maximal 36 ASCII-Zeichen sein. Andernfalls wird der Fehler INVALID_ARGUMENT zurückgegeben.

Die Sitzung beginnt, wenn der Nutzer beginnt, eine Suchanfrage einzugeben, und endet, wenn er einen Ort auswählt und ein „Place Details“- oder „Address Validation“-Aufruf erfolgt. Jede Sitzung kann mehrere Abfragen und eine Anfrage vom Typ „Place Details“ oder „Address Validation“ umfassen. Die Anmeldedaten, die für jede Anfrage innerhalb einer Sitzung verwendet werden, müssen zu demselben Google Cloud Console-Projekt gehören. Nach Abschluss einer Sitzung 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 Place Autocomplete-Aufrufe.
  • Für jede Sitzung muss ein neues Token generiert werden. Wir empfehlen die Verwendung einer UUID der Version 4.
  • Die Anmeldedaten, die für alle Anfragen für die automatische Vervollständigung von Orten, „Places Details“ und die Adressbestätigung innerhalb einer Sitzung verwendet werden, müssen zu demselben 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 einzeln abgerechnet.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine Instanz von Place.