Index
DestinationService(Schnittstelle)GeocodeService(Schnittstelle)Destination(Meldung)Destination.ArrivalSummary(Meldung)Entrance(Meldung)Entrance.Tag(Aufzählung)GeocodeAddressRequest(Meldung)GeocodeAddressRequest.LocationBias(Meldung)GeocodeAddressResponse(Meldung)GeocodeLocationRequest(Meldung)GeocodeLocationResponse(Meldung)GeocodePlaceRequest(Meldung)GeocodeResult(Meldung)GeocodeResult.AddressComponent(Meldung)GeocodeResult.Granularity(Aufzählung)Landmark(Meldung)Landmark.Tag(Aufzählung)NavigationPoint(Meldung)NavigationPoint.TravelMode(Option)NavigationPoint.Usage(Option)PlaceView(Meldung)PlaceView.StructureType(Aufzählung)PlusCode(Meldung)SearchDestinationsRequest(Meldung)SearchDestinationsRequest.AddressQuery(Meldung)SearchDestinationsRequest.LocationQuery(Meldung)SearchDestinationsRequest.LocationQuery.PlaceFilter(Meldung)SearchDestinationsRequest.LocationQuery.PlaceFilter.Addressability(Aufzählung)SearchDestinationsResponse(Meldung)
DestinationService
Ein Dienst zum Abrufen von Zielen.
Ein Zielort bietet hierarchischen Kontext zu einem Ort. So können Sie beispielsweise Mehrfamilienhäuser in einem größeren Wohnkomplex und umgekehrt finden. Außerdem werden Navigationspunkte für Anwendungsfälle wie Mitfahrdienste oder Lieferdienste bereitgestellt.
| SearchDestinations |
|---|
|
Mit dieser Methode wird eine Zielsuche durchgeführt und eine Liste von Zielen zurückgegeben.
|
GeocodeService
Ein Dienst zum Ausführen der Geocodierung.
| GeocodeAddress |
|---|
|
Mit dieser Methode wird eine Adressengeocodierung durchgeführt, bei der eine Adresse einem LatLng zugeordnet wird. Außerdem werden strukturierte Informationen zur Adresse bereitgestellt.
|
| GeocodeLocation |
|---|
|
Mit dieser Methode wird eine Standort-Geocodierung durchgeführt, bei der ein LatLng einer Adresse zugeordnet wird. Außerdem werden strukturierte Informationen zur Adresse bereitgestellt.
|
| GeocodePlace |
|---|
|
Mit dieser Methode wird eine Geocode-Suche anhand einer Orts-ID durchgeführt.
|
Ziel
Ein Ziel Dazu gehören der primäre Ort, zugehörige Orte, Eingänge und Navigationspunkte.
| Felder | |
|---|---|
primary |
Der primäre Ort, der von |
containing_places[] |
Die weniger genauen Orte, die den primären Ort enthalten. Zum Beispiel der Wohnkomplex, in dem sich dieses Gebäude befindet. |
sub_destinations[] |
Genauere Unterziele des primären Orts. Beispiel: Einheiten in einem Gebäude. Hinweis: Im Vergleich zu SubDestination, das von der Places API zurückgegeben wird, ist diese Liste von untergeordneten Zielen umfassender und jedes untergeordnete Ziel enthält mehr Informationen. |
landmarks[] |
Sehenswürdigkeiten, die verwendet werden können, um den Standort des Ziels anzugeben oder die Ankunft zu erleichtern. |
entrances[] |
Eingänge für dieses Ziel. |
navigation_points[] |
Navigationspunkte für dieses Ziel. |
arrival_summary |
KI‑generierte Zusammenfassung der Ankunft am Zielort. |
ArrivalSummary
KI‑generierte Zusammenfassung der Ankunft am Zielort.
| Felder | |
|---|---|
text |
Zusammenfassung der Ankunft am Zielort. |
flag_content_url |
Ein Link, über den Nutzer ein Problem mit der Zusammenfassung melden können. |
disclosure_text |
Nur Ausgabe. Enthält den Offenlegungstext für die Zusammenfassung der Ankunft. |
Eingang
Ein Eingang ist ein einzelnes Breiten-/Längengrad-Koordinatenpaar, das den Standort eines Ein- und Ausgangspunkts für einen Ort definiert.
| Felder | |
|---|---|
location |
Der Standort des Eingangs. |
tags[] |
Eine Liste von Tags, die den Eingang beschreiben. |
place |
Die Struktur, auf der sich dieser Eingang physisch befindet, im Format |
Tag
Merkmale, die einen Einstieg beschreiben.
| Enums | |
|---|---|
TAG_UNSPECIFIED |
Nicht verwendet. |
PREFERRED |
Der Eingang bietet wahrscheinlich physischen Zugang zum primären Ort am zurückgegebenen Ziel. Ein Ort kann mehrere bevorzugte Eingänge haben. Wenn ein Eingang dieses Tag nicht hat, befindet er sich zwar physisch im selben Gebäude wie der primäre Ort, bietet aber nicht unbedingt Zugang zum Ort. Wenn der primäre Ort beispielsweise ein Restaurant in einem Einkaufszentrum ist, sind die „PREFERRED“-Eingänge diejenigen, die wahrscheinlich direkt ins Restaurant führen. Die anderen zurückgegebenen Eingänge sind andere Eingänge für das Gebäude, z. B. Eingänge zu anderen Restaurants im Einkaufszentrum. Wenn der primäre Ort ein Gebäude ist, sind die Hinweis: Ein |
GeocodeAddressRequest
Anfragenachricht für GeocodeService.GeocodeAddress.
| Felder | |
|---|---|
location_bias |
Optional. Die Region, in der gesucht werden soll. Dieser Standort dient als Bias. Das bedeutet, dass Ergebnisse in der Nähe des angegebenen Standorts zurückgegeben werden können. |
language_code |
Optional. Die Sprache, in der die Ergebnisse zurückgegeben werden sollen. |
region_code |
Optional. Regionscode. Der Regionscode, angegeben als zweistelliger Ländercode der Top-Level-Domain (ccTLD). Der Parameter wirkt sich auf die Ergebnisse aus, die auf dem anwendbaren Recht basieren. Dieser Parameter beeinflusst die Ergebnisse des Dienstes, schränkt sie aber nicht vollständig ein. |
Union-Feld address_input. Die Adresse, die geocodiert werden soll. Für address_input ist nur einer der folgenden Werte zulässig: |
|
address_query |
Die unstrukturierte Adresse, die geocodiert werden soll. |
address |
Die strukturierte Adresse, die im Format einer Postanschrift geocodiert werden soll. |
LocationBias
Die Region, in der gesucht werden soll. Dieser Standort dient als Bias. Das bedeutet, dass Ergebnisse in der Nähe des angegebenen Standorts zurückgegeben werden können.
| Felder | |
|---|---|
Union-Feld type. Arten von Standortverzerrungen. Für type ist nur einer der folgenden Werte zulässig: |
|
rectangle |
Ein Rechteck, das durch die Nordost- und die Südwestecke definiert wird. |
GeocodeAddressResponse
Antwortnachricht für GeocodeService.GeocodeAddress.
| Felder | |
|---|---|
results[] |
Das Geocoding-Ergebnis. |
GeocodeLocationRequest
Anfragenachricht für GeocodeService.GeocodeLocation.
| Felder | |
|---|---|
language_code |
Optional. Die Sprache, in der die Ergebnisse zurückgegeben werden sollen. |
region_code |
Optional. Regionscode. Der Regionscode, angegeben als zweistelliger Ländercode der Top-Level-Domain (ccTLD). Der Parameter wirkt sich auf die Ergebnisse aus, die auf dem anwendbaren Recht basieren. |
types[] |
Optional. Eine Reihe von Typ-Tags, um die Ergebnisse einzuschränken. Ergebnisse, die keinen der angegebenen Typen haben, werden entfernt. Eine vollständige Liste der möglichen Werte finden Sie in Tabelle A und Tabelle B unter https://developers.google.com/maps/documentation/places/web-service/place-types. |
granularity[] |
Optional. Ein Filter mit einem oder mehreren Enums für die Standortgenauigkeit. |
Union-Feld location_input. Der zu geocodierende Ort. Für location_input ist nur einer der folgenden Werte zulässig: |
|
location_query |
Der Standort im Format „lat,lng“ (String). Beispiel: „64.7611872,-18.4705364“. |
location |
Der Standort im strukturierten Format. |
GeocodeLocationResponse
Antwortnachricht für GeocodeService.GeocodeLocation.
| Felder | |
|---|---|
results[] |
Das Geocoding-Ergebnis. |
plus_code |
Plus Code des Standorts in der Anfrage. |
GeocodePlaceRequest
Anfragenachricht für GeocodeService.GeocodePlace.
| Felder | |
|---|---|
place |
Erforderlich. Orts-ID für die Geocodierung im Format „places/{place}“. |
language_code |
Optional. Die Sprache, in der die Ergebnisse zurückgegeben werden sollen. |
region_code |
Optional. Regionscode. Der Regionscode, angegeben als zweistelliger Ländercode der Top-Level-Domain (ccTLD). Der Parameter wirkt sich auf die Ergebnisse aus, die auf dem anwendbaren Recht basieren. |
GeocodeResult
Ein Geocode-Ergebnis enthält geografische Informationen zu einem Ort.
| Felder | |
|---|---|
place |
Die vollqualifizierte Orts-ID für dieses Ergebnis. Im Format „//places.googleapis.com/places/{placeID}“. Weitere Informationen finden Sie unter https://developers.google.com/maps/documentation/places/web-service/place-id. |
place_id |
Die Orts-ID für dieses Ergebnis. |
location |
Die Längen- und Breitengrade dieser Adresse. |
granularity |
Die Granularität des Standorts. |
viewport |
Ein Darstellungsbereich, der sich für die Anzeige des Geocoding-Ergebnisses eignet. |
bounds |
Ein Begrenzungsrahmen für die Adresse. |
formatted_address |
Die als eine Zeile formatierte Adresse. |
postal_address |
Die Adresse im Format einer Postadresse. |
address_components[] |
Wiederholte Komponenten für jede Lokalitätsebene. |
postal_code_localities[] |
Vollständige Liste der Orte, die in der Postleitzahl enthalten sind. Dieses Feld wird nur ausgefüllt, wenn das Ergebnis vom Typ „postal_code“ ist. |
types[] |
Eine Reihe von Typ-Tags für dieses Ergebnis. Beispiele: „political“ und „administrative_area“. Eine vollständige Liste der möglichen Werte finden Sie in Tabelle A und Tabelle B unter https://developers.google.com/maps/documentation/places/web-service/place-types. |
plus_code |
Der Plus Code des Standorts in diesem Geocode. |
AddressComponent
Die strukturierten Komponenten, aus denen die formatierte Adresse besteht, sofern diese Informationen verfügbar sind.
| Felder | |
|---|---|
long_text |
Die Volltextbeschreibung oder der Name der Adresskomponente. Beispielsweise könnte eine Adresskomponente für das Land Australien den Langnamen „Australia“ haben. |
short_text |
Ein abgekürzter Textname für die Adresskomponente, falls vorhanden. Beispielsweise könnte eine Adresskomponente für das Land Australien den Kurznamen „AU“ haben. |
types[] |
Ein Array, das den oder die Typen der Adresskomponente angibt. Weitere Informationen finden Sie unter https://developers.google.com/maps/documentation/geocoding/requests-geocoding#Types. |
language_code |
Die Sprache, die zum Formatieren dieser Komponenten verwendet wird, in CLDR-Notation. |
Detaillierungsgrad
Die Granularität des Standorts.
| Enums | |
|---|---|
GRANULARITY_UNSPECIFIED |
Nicht verwenden. |
ROOFTOP |
Der nicht interpolierte Standort eines tatsächlichen Grundstücks, das der abgeglichenen Adresse entspricht. |
RANGE_INTERPOLATED |
Interpoliert aus einer Reihe von Hausnummern. Wenn wir beispielsweise wissen, dass ein Abschnitt des Amphitheatre Parkway die Hausnummern 1600 bis 1699 umfasst, wird die Hausnummer 1650 möglicherweise in der Mitte zwischen den Endpunkten platziert. |
GEOMETRIC_CENTER |
Der geometrische Mittelpunkt eines Elements, für das wir Polygondaten haben. |
APPROXIMATE |
Alles andere. |
Sehenswürdigkeit
Orientierungspunkte werden verwendet, um das Ziel zu kommunizieren oder die Ankunft am Ziel zu erleichtern.
| Felder | |
|---|---|
relational_description |
Eine für Menschen lesbare Beschreibung, wie das Ziel mit dem Orientierungspunkt zusammenhängt. Beispiele: „In der Nähe des Empire State Building“ oder „Gegenüber dem Weißen Haus“. |
tags[] |
Tags, die beschreiben, wie das Wahrzeichen im Kontext des Ziels verwendet werden kann. |
straight_line_distance_meters |
Nur Ausgabe. Die Luftlinie von diesem Orientierungspunkt zum Ziel in Metern. |
travel_distance_meters |
Nur Ausgabe. Die Entfernung vom Straßennetz von diesem Orientierungspunkt zum Zielort in Metern. |
Union-Feld landmark. Die Markierung. Für landmark ist nur einer der folgenden Werte zulässig: |
|
place |
Der Ort, der dieses Wahrzeichen repräsentiert. |
Tag
Die Liste aller möglichen Tags, die beschreiben, wie ein Wahrzeichen im Kontext eines Reiseziels verwendet werden kann.
Wenn eine Adresse sowohl das Tag ADDRESS als auch das Tag ARRIVAL hat, ist das Wahrzeichen sowohl lokal bekannt als auch in der Nähe des Zielorts.
| Enums | |
|---|---|
TAG_UNSPECIFIED |
Nicht verwendet. |
ADDRESS |
Ein lokal bekannter Ort, der verwendet werden kann, um den allgemeinen Standort des Ziels zu identifizieren. Normalerweise innerhalb weniger Hundert Meter vom Ziel entfernt. Diese ähneln den Orientierungspunkten, die von der Funktion „Adressdeskriptoren“ der Geocoding API zurückgegeben werden: https://developers.google.com/maps/documentation/geocoding/address-descriptors/requests-address-descriptors. |
ARRIVAL |
Ein Ort, der als Orientierungshilfe für die Ankunft am Zielort dienen kann. Nützlich für die Navigation, wenn Sie sich in der Nähe des Ziels befinden. Das kann beispielsweise ein Ort sein, der sich auf der gegenüberliegenden Straßenseite des Ziels befindet. Ein Orientierungspunkt mit diesem Tag liegt in der Regel näher am Ziel als Orientierungspunkte mit dem Tag ADDRESS. |
PlaceView
Stellt eine Ansicht eines Orts in der Places API dar. Außerdem enthält sie zusätzliche Informationen zu Zielen, z. B. den Strukturtyp und das Anzeigepolygon.
In einigen Fällen kann sich ein PlaceView mit derselben Orts-ID von dem unterscheiden, was von der Places API für die Felder types und display_name zurückgegeben wird.
| Felder | |
|---|---|
place |
Der Ressourcenname dieses Orts im Format |
display_name |
Menschenlesbare Ortsbeschreibung. Beispiele: „Gate B“, „McDonalds“ |
primary_type |
Der primäre Ortstyp dieses Orts. Eine Liste der möglichen Werte finden Sie unter https://developers.google.com/maps/documentation/places/web-service/place-types. Hinweis: Dieses Feld wird nicht immer ausgefüllt. In solchen Fällen sollten Sie das Feld |
types[] |
Alle zugehörigen Ortstypen dieses Orts. Eine Liste der möglichen Werte finden Sie unter https://developers.google.com/maps/documentation/places/web-service/place-types. |
formatted_address |
Eine Zeile für die Adresse. |
postal_address |
Strukturierte Adresse. |
structure_type |
Der Strukturtyp, der diesem Ort entspricht. |
location |
Der Standort dieses Orts. Bei Orten mit Anzeigepolygonen kann dies ein guter Ort sein, um eine Markierung auf der Karte zu platzieren. |
display_polygon |
Die Polygonumrisslinie des Orts im GeoJSON-Format gemäß RFC 7946: https://datatracker.ietf.org/doc/html/rfc7946#section-3.1.6. Hinweis: Das RFC 7946-Format unterstützt MultiPolygons. Ein |
StructureType
Der Typ der Struktur, die dieser Ort darstellt.
| Enums | |
|---|---|
STRUCTURE_TYPE_UNSPECIFIED |
Nicht verwendet. |
POINT |
Ein Punktstandort. |
SECTION |
Ein Unterabschnitt eines Gebäudes. |
BUILDING |
Ein Gebäude. |
GROUNDS |
Ein großes Gebiet, das in der Regel mehrere Gebäude umfasst, z. B. ein Universitätsgelände, ein Wohnkomplex oder ein Einkaufszentrum. |
PlusCode
Der Plus Code (http://plus.codes) ist ein Standortverweis mit zwei Formaten: einem globalen Code, der ein Rechteck von 14 m × 14 m (1/8.000stel eines Grades) oder kleiner definiert, und einem zusammengesetzten Code, bei dem das Präfix durch einen Referenzstandort ersetzt wird.
| Felder | |
|---|---|
global_code |
Der globale (vollständige) Code des Orts, z. B. „9FWM33GV+HQ“, der einen Bereich von 1/8.000 × 1/8.000 Grad (~14 × 14 Meter) darstellt. |
compound_code |
Der zusammengesetzte Code des Orts, z. B. „33GV+HQ, Ramberg, Norwegen“, der das Suffix des globalen Codes enthält und das Präfix durch einen formatierten Namen einer Referenzentität ersetzt. |
SearchDestinationsRequest
Anfragenachricht für DestinationService.SearchDestinations
| Felder | |
|---|---|
travel_modes[] |
Optional. Die Mobilitätsformen, nach denen Navigationspunkte gefiltert werden sollen. Dies wirkt sich auf das Feld |
language_code |
Optional. Die Sprache, in der die Ergebnisse zurückgegeben werden sollen. |
region_code |
Optional. Regionscode. Der Regionscode, angegeben als zweistelliger Ländercode der Top-Level-Domain (ccTLD). Der Parameter wirkt sich auf die Ergebnisse aus, die auf dem anwendbaren Recht basieren. Dieser Parameter beeinflusst auch die Ergebnisse des Dienstes, schränkt sie aber nicht vollständig ein. |
Union-Feld Die Ziele basieren auf der angegebenen Primärabfrage. Hinweis: Es werden nur Orte und Adressen unterstützt, die als Navigationsziel verwendet werden können. Ein Ort, der ein Haus oder einen Wohnkomplex darstellt, kann beispielsweise als primäre Anfrage verwendet werden. Orte, die eine Ortschaft oder eine Verwaltungseinheit darstellen, können jedoch nicht als primäre Anfrage verwendet werden. Für |
|
place |
Der Ressourcenname eines Orts im Format |
address_query |
Eine Adresse. |
location_query |
Einen genauen Standort. |
AddressQuery
Die Adresse, nach der Sie suchen möchten. Geben Sie Adressen im vom Postdienst des jeweiligen Landes verwendeten Format an.
| Felder | |
|---|---|
Union-Feld kind. Die Adressabfrage. Für kind ist nur einer der folgenden Werte zulässig: |
|
address |
Eine Straßenadresse im Format einer Postanschrift. |
address_query |
Eine Adresse, die als eine Zeile formatiert ist. |
LocationQuery
Eine Standortanfrage, um ein primäres Ziel in der Nähe zu ermitteln.
Hinweis: Wenn sich die Standortanfrage in einem Gebäude mit untergeordneten Räumlichkeiten befindet, kann es sein, dass der zurückgegebene primäre Ort eine untergeordnete Räumlichkeit ist. In diesen Fällen enthält das Feld „containing_places“ das Gebäude.
| Felder | |
|---|---|
place_filter |
Optional. Filter, die auf Zielkandidaten angewendet werden sollen. |
Union-Feld kind. Die Standortabfrage. Für kind ist nur einer der folgenden Werte zulässig: |
|
location |
Ein genauer LatLng-Standort. |
PlaceFilter
Filter, die auf Zielkandidaten angewendet werden sollen.
| Felder | |
|---|---|
structure_type |
Optional. Wenn angegeben, haben alle Ziele garantiert einen primären Ort mit diesem Strukturtyp. Dies kann dazu führen, dass einige Ziele herausgefiltert oder die zurückgegebenen Ziele gröber oder feiner dargestellt werden. Wenn beispielsweise Dieses Feld kann auch verwendet werden, um leichter Polygone für die Darstellung von Gebäuden zu extrahieren. Wenn beispielsweise |
addressability |
Optional. Falls angegeben, werden nur Ziele zurückgegeben, die die entsprechenden Kriterien für die Adressierbarkeit erfüllen. |
Adressierbarkeit
Definiert Optionen für die Filterung der Adressierbarkeit. In Zukunft werden möglicherweise neue Werte hinzugefügt.
| Enums | |
|---|---|
ADDRESSABILITY_UNSPECIFIED |
Wenn kein Wert angegeben ist, wählt der Dienst einen angemessenen Standardwert aus. |
ANY |
Die Adressierbarkeit ist kein Filterkriterium. Ziele werden unabhängig von ihrer Adressierbarkeit zurückgegeben. |
PRIMARY |
Alle zurückgegebenen Ziele haben einen primären Ort mit einer Adresse oder einem Namen auf Straßenebene. |
WEAK |
Alle zurückgegebenen Ziele haben entweder einen primären Ort oder ein Unterziel mit einer Adresse oder einem Namen auf Straßenebene. |
SearchDestinationsResponse
Antwortnachricht für DestinationService.SearchDestinations.
| Felder | |
|---|---|
destinations[] |
Eine Liste mit Zielen. Der Dienst gibt ein Ergebnis zurück, wenn ein primäres Ziel anhand der primären Anfrage eindeutig identifiziert werden kann. Andernfalls gibt der Dienst möglicherweise mehrere Ergebnisse zur Eindeutigkeit oder keine Ergebnisse zurück. |