Package google.maps.geocode.v4alpha

Index

DestinationService

Ein Dienst zum Abrufen von Zielen.

Ein Zielort bietet hierarchischen Kontext zu einem Ort. So können Sie beispielsweise Apartmentgebäude innerhalb eines größeren Apartmentkomplexes und umgekehrt finden. Außerdem werden Navigationspunkte für Anwendungsfälle wie Mitfahrdienste oder Lieferungen bereitgestellt.

SearchDestinations

rpc SearchDestinations(SearchDestinationsRequest) returns (SearchDestinationsResponse)

Mit dieser Methode wird eine Zielsuche durchgeführt und eine Liste von Zielen zurückgegeben.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/maps-platform.geocode

Ziel

Ein Ziel Dazu gehören der primäre Ort, zugehörige Orte, Eingänge und Navigationspunkte.

Felder
primary

PlaceView

Der primäre Ort, der von primary_query in der Anfrage angegeben wird.
containing_places[]

PlaceView

Die weniger genauen Orte, die den primären Ort enthalten. Zum Beispiel der Wohnkomplex, in dem sich dieses Gebäude befindet.
sub_destinations[]

PlaceView

Genauere Unterziele des primären Ortes. Beispiel: Einheiten in einem Gebäude.

Hinweis: Im Vergleich zu SubDestination, das von der Places API zurückgegeben wird, ist diese Liste mit untergeordneten Zielen umfassender und jedes untergeordnete Ziel enthält mehr Informationen.
landmarks[]

Landmark

Sehenswürdigkeiten, die verwendet werden können, um den Standort des Ziels anzugeben oder die Ankunft zu erleichtern.
entrances[]

Entrance

Eingänge für dieses Ziel.
navigation_points[]

NavigationPoint

Navigationspunkte für dieses Ziel.

Eingang

Ein Eingang ist ein einzelnes Breiten-/Längengrad-Koordinatenpaar, das die Position eines Ein- und Ausgangspunkts für einen Ort definiert.

Felder
location

LatLng

Der Standort des Eingangs.
tags[]

Entrance.Tag

Eine Liste von Tags, die den Eingang beschreiben.
place

string

Die Struktur, auf der sich dieser Eingang physisch befindet, im Format places/{place_id}.

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 PREFERRED-Eingänge diejenigen, die in den „Haupt“-Teil des Gebäudes führen. In einem Einkaufszentrum sind beispielsweise die Eingänge, die den Zugang zum Hauptfoyer ermöglichen, PREFERRED-Eingänge. Wenn ein Eingang nur den Zugang zu einem Geschäft an der Seite des Gebäudes ermöglicht, ist er kein PREFERRED-Eingang.

Hinweis: Ein PREFERRED-Eingang bietet möglicherweise keinen Zugang zum primären Ort und ein nicht PREFERRED-Eingang bietet möglicherweise Zugang zum primären Ort.

Sehenswürdigkeit

Orientierungspunkte werden verwendet, um den Standort des Ziels anzugeben oder die Ankunft am Ziel zu erleichtern.

Felder
tags[]

Landmark.Tag

Tags, die beschreiben, wie das Wahrzeichen im Kontext des Ziels verwendet werden kann.
Union-Feld landmark. Die Sehenswürdigkeit. Für landmark ist nur einer der folgenden Werte zulässig:
place

PlaceView

Der Ort, der dieses Wahrzeichen repräsentiert.

Tag

Die Liste aller möglichen Tags, die beschreiben, wie ein Orientierungspunkt im Kontext eines Ziels verwendet werden kann.

Wenn eine Adresse sowohl das Tag ADDRESS als auch 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 ermitteln. 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.

Ein Navigationspunkt ist ein Ort neben einer Straße, an dem die Navigation enden kann.

Felder
display_name

LocalizedText

Der Anzeigename dieses Navigationspunkts. Beispiel: „5th Ave“ oder „Gate B“.
location

LatLng

Ein Punkt neben dem Straßenabschnitt, an dem die Navigation enden soll. Der Punkt ist absichtlich leicht von der Mittellinie der Straße versetzt, um die Straßenseite, auf der sich der Ort befindet, deutlich zu kennzeichnen.
travel_modes[]

NavigationPoint.TravelMode

Für diesen Navigationspunkt geeignete Fortbewegungsmittel.
usages[]

NavigationPoint.Usage

Verwendungszwecke, die von diesem Navigationspunkt unterstützt werden.

TravelMode

Für diesen Navigationspunkt geeignete Fortbewegungsmittel.

Enums
TRAVEL_MODE_UNSPECIFIED Nicht verwendet.
DRIVE Zum Fahren geeignet.
WALK Zum Spazierengehen geeignet.

Nutzung

Verwendungszwecke, die von diesem Navigationspunkt unterstützt werden.

Enums
USAGE_UNSPECIFIED Nicht verwendet.
UNKNOWN Unbekannter Nutzungstyp. Die meisten Navigationspunkte sind UNKNOWN. Das bedeutet nicht unbedingt, dass ihre Nutzung in irgendeiner Weise eingeschränkt ist. Diese Navigation ist möglicherweise trotzdem für die Abholung und/oder Zustellung geeignet.
DROPOFF Geeignet zum Aussteigenlassen von Fahrgästen. Beispiel: Ein Abholort für Mitfahrdienste.
PICKUP Geeignet für die Abholung eines Fahrgasts. Beispiel: Treffpunkt für Mitfahrgelegenheiten.

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 den Werten unterscheiden, die von der Places API für die Felder types und display_name zurückgegeben werden.

Felder
place

string

Der Ressourcenname dieses Orts im Format places/{placeId}.
display_name

LocalizedText

Für Menschen lesbare Ortsbeschreibung. Beispiele: „Gate B“, „McDonalds“
primary_type

string

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 ist nicht immer ausgefüllt. In solchen Fällen sollten Sie das Feld types verwenden.
types[]

string

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

string

Eine Zeile für die Adresse.
postal_address

PostalAddress

Strukturierte Adresse.
structure_type

PlaceView.StructureType

Der Typ der Struktur, die diesem Ort entspricht.
location

LatLng

Der Standort dieses Orts. Bei Orten mit Anzeigepolygonen kann dies ein guter Ort sein, um eine Markierung auf der Karte zu platzieren.
display_polygon

Struct

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 display_polygon-Objekt kann also mehrere Polygone darstellen.

StructureType

Die Art 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.

SearchDestinationsRequest

Anfragenachricht für DestinationService.SearchDestinations

Felder
travel_modes[]

NavigationPoint.TravelMode

Optional. Die Mobilitätsformen, nach denen Navigationspunkte gefiltert werden sollen. Dies wirkt sich auf das Feld navigation_points aus, das in der Antwort zurückgegeben wird. Wenn leer, können Navigationspunkte aller Mobilitätsformen zurückgegeben werden.
language_code

string

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

string

Optional. Regionscode. Der Regionscode, angegeben als zweistelliger Ländercode der Top-Level-Domain (ccTLD). Der Parameter wirkt sich auf Ergebnisse aus, die auf anwendbarem Recht basieren. Dieser Parameter beeinflusst auch die Ergebnisse des Dienstes, schränkt sie aber nicht vollständig ein.

Union-Feld primary_query. Fragen Sie nach dem primären Ziel. Das kann ein Ort, eine vollständig angegebene Adresse oder ein LatLng-Standort sein. Einige Orte und Adressen mit minimalen Informationen können nicht in ein Ziel umgewandelt werden.

Die Ziele basieren auf der angegebenen Primärabfrage.

Hinweis: Es werden nur Orte und Adressen unterstützt, die als Navigationsziel dienen können. Ein Ort, der ein Haus oder einen Wohnkomplex darstellt, kann beispielsweise als primäre Anfrage verwendet werden. Orte, die eine Ortschaft oder ein Verwaltungsgebiet darstellen, können jedoch nicht als primäre Anfrage verwendet werden. Für primary_query ist nur einer der folgenden Werte zulässig:
place

string

Der Ressourcenname eines Orts im Format places/{place_id}.
address_query

SearchDestinationsRequest.AddressQuery

Eine Adresse.
location_query

SearchDestinationsRequest.LocationQuery

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

PostalAddress

Eine Straßenadresse im Format einer Postanschrift.
address_query

string

Eine Adresse, die als eine Zeile formatiert ist.

LocationQuery

Eine Standortabfrage, 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
Union-Feld kind. Die Standortabfrage. Für kind ist nur einer der folgenden Werte zulässig:
location

LatLng

Ein genauer LatLng-Standort.

SearchDestinationsResponse

Antwortnachricht für DestinationService.SearchDestinations.

Felder
destinations[]

Destination

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.