- HTTP-Anfrage
- Anfragetext
- Antworttext
- Autorisierungsbereiche
- SearchDestinationsRequest.AddressQuery
- SearchDestinationsRequest.LocationQuery
- SearchDestinationsRequest.LocationQuery.PlaceFilter
- PlaceView.StructureType
- SearchDestinationsRequest.LocationQuery.PlaceFilter.Addressability
- NavigationPoint.TravelMode
- Destination
- PlaceView
- PlaceView.AddressComponent
- Landmark
- Landmark.Tag
- Eingang
- Entrance.Tag
- StreetViewThumbnail
- ImageAnnotation
- ImageAnnotation.Coordinate
- NavigationPoint
- NavigationPoint.Usage
- Destination.ParkingOptions
- Destination.ParkingOptions.Availability
- Destination.ParkingOptions.ParkingFacility
- Destination.ArrivalSummary
Diese Methode führt eine Zielsuche durch und gibt eine Liste von Zielen zurück.
HTTP-Anfrage
POST https://geocode.googleapis.com/v4alpha/geocode/destinations
Die URL verwendet die Syntax der gRPC-Transcodierung.
Anfragetext
Der Anfragetext enthält Daten mit folgender Struktur:
| JSON-Darstellung |
|---|
{ "travelModes": [ enum ( |
| Felder | |
|---|---|
travelModes[] |
Optional. Die Mobilitätsformen, nach denen Navigationspunkte gefiltert werden sollen. Dies wirkt sich auf das Feld |
languageCode |
Optional. Sprache, in der die Ergebnisse zurückgegeben werden sollen. |
regionCode |
Optional. Regionscode. Der Regionscode, angegeben als zweistelliger Wert für die länderspezifische Top-Level-Domain (ccTLD). Der Parameter wirkt sich auf die Ergebnisse gemäß geltendem Recht aus. Durch diesen Parameter werden die Ergebnisse des Dienstes zwar beeinflusst, aber nicht vollständig eingeschränkt. |
Fragen Sie das primäre Ziel ab. 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 werden um die angegebene Primärabfrage herum erstellt. Hinweis: Es werden nur Orte und Adressen unterstützt, die als Navigationsziel verwendet werden können. Beispielsweise kann ein Ort, der ein Haus oder einen Apartmentkomplex darstellt, als Primärabfrage verwendet werden, Orte, die eine Ortschaft oder ein Verwaltungsgebiet darstellen, jedoch nicht. Im Folgenden finden Sie eine Liste der Felder, die sich gegenseitig ausschließen. In einer Antwort wird höchstens eines der Felder festgelegt: |
|
place |
Der Ressourcenname eines Orts im |
addressQuery |
Eine Adresse. |
locationQuery |
Ein genauer Standort. |
| Ende der sich gegenseitig ausschließenden Felder. | |
Antworttext
Antwortnachricht für DestinationService.SearchDestinations.
Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:
| JSON-Darstellung |
|---|
{
"destinations": [
{
object ( |
| Felder | |
|---|---|
destinations[] |
Eine Liste der Ziele. Der Dienst gibt ein Ergebnis zurück, wenn ein primäres Ziel eindeutig aus der primären Abfrage identifiziert werden kann. Andernfalls gibt der Dienst möglicherweise mehrere Ergebnisse zur Mehrdeutigkeitsauflösung oder gar keine Ergebnisse zurück. |
Autorisierungsbereiche
Erfordert einen der folgenden OAuth-Bereiche:
https://www.googleapis.com/auth/cloud-platformhttps://www.googleapis.com/auth/maps-platform.geocodehttps://www.googleapis.com/auth/maps-platform.destinations
SearchDestinationsRequest.AddressQuery
Die Adresse, nach der Sie suchen möchten. Geben Sie Adressen im vom Postdienst des jeweiligen Landes verwendeten Format an.
| JSON-Darstellung |
|---|
{
// The following is a list of mutually exclusive fields. At most one of the
// fields will be set in a response:
"address": {
object ( |
| Felder | |
|---|---|
| Die Adressabfrage. Im Folgenden finden Sie eine Liste der Felder, die sich gegenseitig ausschließen. In einer Antwort wird höchstens eines der Felder festgelegt: | |
address |
Eine Adresse im Postanschriftformat. |
addressQuery |
Eine Adresse, die als einzelne Zeile formatiert ist. |
| Ende der sich gegenseitig ausschließenden Felder. | |
SearchDestinationsRequest.LocationQuery
Eine Standortabfrage, um ein primäres Ziel in der Nähe zu ermitteln.
Hinweis: Wenn sich die Standortabfrage innerhalb eines Gebäudes mit Untergebäuden befindet, kann es sein, dass der zurückgegebene primäre Ort ein Untergebäude ist. In diesen Fällen enthält das Feld containingPlaces das Gebäude.
| JSON-Darstellung |
|---|
{ "placeFilter": { object ( |
| Felder | |
|---|---|
placeFilter |
Optional. Filter, die auf Zielkandidaten angewendet werden sollen. |
| Die Standortabfrage. Im Folgenden finden Sie eine Liste der Felder, die sich gegenseitig ausschließen. In einer Antwort wird höchstens eines der Felder festgelegt: | |
location |
Ein genauer LatLng-Standort. |
| Ende der sich gegenseitig ausschließenden Felder. | |
SearchDestinationsRequest.LocationQuery.PlaceFilter
Filter, die auf Zielkandidaten angewendet werden sollen.
| JSON-Darstellung |
|---|
{ "structureType": enum ( |
| Felder | |
|---|---|
structureType |
Optional. Wenn angegeben, haben alle Ziele garantiert einen primären Ort mit diesem Strukturtyp. Dies kann dazu führen, dass einige Ziele herausgefiltert werden oder die zurückgegebenen Ziele vergröbert oder verfeinert werden. Wenn beispielsweise Dieses Feld kann auch verwendet werden, um Polygone für die Gebäudedarstellung einfacher zu extrahieren. Wenn beispielsweise |
addressability |
Optional. Wenn angegeben, werden nur Ziele zurückgegeben, die die entsprechenden Adressierbarkeitskriterien erfüllen. |
PlaceView.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ätscampus, ein Apartmentkomplex oder ein Einkaufszentrum. |
SearchDestinationsRequest.LocationQuery.PlaceFilter.Addressability
Definiert Optionen für die Filterung nach Adressierbarkeit. In Zukunft werden möglicherweise neue Werte hinzugefügt.
| Enums | |
|---|---|
ADDRESSABILITY_UNSPECIFIED |
Wenn nichts angegeben ist, wählt der Dienst einen sinnvollen 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 auf Straßenebene oder einem Namen. |
WEAK |
Alle zurückgegebenen Ziele haben entweder einen Hauptort oder ein Unterziel mit einer Adresse oder einem Namen auf Straßenebene. |
Ziel
Ein Ziel Dazu gehören der Hauptort, zugehörige Orte, Eingänge und Navigationspunkte.
| JSON-Darstellung |
|---|
{ "primary": { object ( |
| Felder | |
|---|---|
primary |
Der primäre Ort, der durch die |
containingPlaces[] |
Die weniger genauen Orte, die den primären Ort enthalten. Beispiel: der Apartmentkomplex, zu dem dieses Gebäude gehört. |
subDestinations[] |
Genauere Unterziele des primären Ortes. Beispiel: Einheiten in einem Gebäude. Hinweis: Im Vergleich zu den von der Places API zurückgegebenen SubDestination-Objekten ist diese Liste von Unterzielen umfassender und jedes Unterziel enthält mehr Informationen. |
landmarks[] |
Orientierungspunkte, die verwendet werden können, um zu kommunizieren, wo sich das Ziel befindet, oder um die Ankunft zu erleichtern. |
entrances[] |
Eingänge für dieses Ziel. |
navigationPoints[] |
Navigationspunkte für dieses Ziel. |
parkingOptions |
Parkmöglichkeiten für dieses Ziel. |
arrivalSummary |
KI-generierte Zusammenfassung der Ankunft am Zielort. |
PlaceView
Stellt eine Ansicht eines Ortes in der Places API dar. Außerdem werden zusätzliche Informationen zu Zielen bereitgestellt, z. B. der 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 displayName zurückgegeben wird.
| JSON-Darstellung |
|---|
{ "place": string, "placeId": string, "displayName": { object ( |
| Felder | |
|---|---|
place |
Der Ressourcenname dieses Orts im Format |
placeId |
Die eindeutige Kennung eines Ortes. |
displayName |
Menschenlesbare Beschreibung des Ortes. Beispiel: „Gate B“, „McDonalds“ |
primaryType |
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. Seien Sie darauf vorbereitet, in solchen Situationen das Feld |
types[] |
Alle mit diesem Ort verknüpften Ortstypen. Eine Liste der möglichen Werte finden Sie unter https://developers.google.com/maps/documentation/places/web-service/place-types. |
formattedAddress |
Einzeilige Adresse. |
postalAddress |
Strukturierte Adresse. |
structureType |
Der Typ des Gebäudes, das diesem Ort entspricht. |
location |
Der Standort dieses Ortes. Bei Orten mit Anzeigepolygonen kann dies ein guter Ort sein, um eine Markierung auf der Karte zu platzieren. |
displayPolygon |
Der Polygonumriss des Ortes 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, sodass ein |
addressComponents[] |
Wiederholte Komponenten für jede Ortsebene. |
PlaceView.AddressComponent
Die strukturierten Komponenten, aus denen die formatierte Adresse besteht, sofern diese Informationen verfügbar sind.
| JSON-Darstellung |
|---|
{ "longText": string, "shortText": string, "types": [ string ], "languageCode": string } |
| Felder | |
|---|---|
longText |
Die Volltextbeschreibung oder der Name der Adresskomponente. Beispielsweise könnte eine Adresskomponente für das Land Australien den langen Namen „Australien“ haben. |
shortText |
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 Typ oder die Typen der Adresskomponente angibt. Diese Werte stammen aus der Tabelle mit Adresstypen und Adresskomponententypen, die von der Places API verwendet wird: https://developers.google.com/maps/documentation/places/web-service/place-types#address-types |
languageCode |
Die Sprache, die zum Formatieren dieser Komponente verwendet wird, in CLDR-Notation. |
Sehenswürdigkeit
Orientierungspunkte werden verwendet, um zu kommunizieren, wo sich das Ziel befindet, oder um das Erreichen des Ziels zu erleichtern.
| JSON-Darstellung |
|---|
{ "relationalDescription": { object ( |
| Felder | |
|---|---|
relationalDescription |
Eine menschenlesbare Beschreibung, wie das Ziel mit der Sehenswürdigkeit zusammenhängt. Beispiel: „In der Nähe des Empire State Building“ oder „Gegenüber dem Weißen Haus“. |
tags[] |
Tags, die beschreiben, wie die Landmarke im Kontext des Ziels verwendet werden kann. |
straightLineDistanceMeters |
Nur Ausgabe. Die Luftlinie von dieser Sehenswürdigkeit zum Ziel in Metern. |
travelDistanceMeters |
Nur Ausgabe. Die Entfernung von diesem Orientierungspunkt zum Ziel in Metern. |
| Die Sehenswürdigkeit. Im Folgenden finden Sie eine Liste der Felder, die sich gegenseitig ausschließen. In einer Antwort wird höchstens eines der Felder festgelegt: | |
place |
Der Ort, der diese Sehenswürdigkeit darstellt. |
| Ende der sich gegenseitig ausschließenden Felder. | |
Landmark.Tag
Die Liste aller möglichen Tags, die beschreiben, wie eine Sehenswürdigkeit im Kontext eines Reiseziels verwendet werden kann.
Wenn eine Adresse sowohl das Tag ADDRESS als auch das Tag ARRIVAL hat, bedeutet das, dass die Sehenswürdigkeit sowohl lokal bekannt als auch in der Nähe des Ziels ist.
| Enums | |
|---|---|
TAG_UNSPECIFIED |
Nicht verwendet. |
ADDRESS |
Ein lokal bekannter Ort, der verwendet werden kann, um den ungefähren Standort des Ziels zu ermitteln. In der Regel innerhalb weniger hundert Meter vom Ziel entfernt. Diese ähneln den Sehenswürdigkeiten, 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 dient, um das Ziel zu erreichen. Nützlich für die Navigation, wenn Sie sich in der Nähe des Ziels befinden. Diese Landmarke kann sich beispielsweise auf der gegenüberliegenden Straßenseite des Ziels befinden. Ein Orientierungspunkt mit diesem Tag ist in der Regel näher am Ziel als Orientierungspunkte mit dem Tag ADDRESS. |
Eingang
Ein Eingang ist ein einzelnes Koordinatenpaar aus Breiten- und Längengrad, das die Position eines Ein- und Ausgangs für einen Ort definiert.
| JSON-Darstellung |
|---|
{ "displayName": { object ( |
| Felder | |
|---|---|
displayName |
Menschenlesbarer Name, z.B. „Tor B“, „Südeingang“, „Eingang 5th Ave“. |
location |
Der Standort des Eingangs. |
tags[] |
Eine Liste von Tags, die den Eingang beschreiben. |
place |
Das Gebäude, in dem sich dieser Eingang befindet, im Format |
streetViewThumbnail |
Street View-Miniaturansicht, die den Eingang zeigt. Das Bild kann über die Street View Static API angefordert werden. Weitere Informationen finden Sie unter https://developers.google.com/maps/documentation/streetview/request-streetview. |
streetViewAnnotation |
Anmerkung des Eingangs auf der oben zurückgegebenen |
Entrance.Tag
Merkmale, die einen Eingang beschreiben.
| Enums | |
|---|---|
TAG_UNSPECIFIED |
Nicht verwendet. |
PREFERRED |
Der Eingang bietet wahrscheinlich physischen Zugang zum Hauptort 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 Hauptort, bietet aber nicht unbedingt Zugang zu diesem Ort. Wenn der primäre Ort beispielsweise ein Restaurant in einem Einkaufszentrum ist, sind die „PREFERRED“-Eingänge diejenigen, die wahrscheinlich in das Restaurant selbst führen. Die anderen zurückgegebenen Eingänge sind andere Eingänge des Gebäudes, z. B. Eingänge zu anderen Restaurants im Einkaufszentrum. Wenn der Hauptort ein Gebäude ist, sind die Hinweis: Ein |
StreetViewThumbnail
Parameter für die Darstellung einer Google Street View-Miniaturansicht. Mit diesen Parametern können Sie ein Street View-Bild von der Street View Static API anfordern. Weitere Informationen finden Sie unter https://developers.google.com/maps/documentation/streetview/request-streetview.
| JSON-Darstellung |
|---|
{ "pano": string, "widthPx": integer, "heightPx": integer, "headingDegree": number, "pitchDegree": number, "fovDegree": number } |
| Felder | |
|---|---|
pano |
Eine bestimmte Panorama-ID. |
widthPx |
Breite des Ausgabe-Thumbnail-Bildes in Pixeln. Hinweis: Wenn Sie Annotations zusammen mit dem Thumbnail anfordern, müssen diese Höhen- und Breitenwerte in der Street View API-Anfrage verwendet werden, damit die Koordinaten der Annotations korrekt mit dem Bild übereinstimmen. |
heightPx |
Höhe des Ausgabe-Miniaturansichtsbilds in Pixeln. Hinweis: Wenn Sie Annotations zusammen mit dem Thumbnail anfordern, müssen diese Höhen- und Breitenwerte in der Street View API-Anfrage verwendet werden, damit die Koordinaten der Annotations korrekt mit dem Bild übereinstimmen. |
headingDegree |
Horizontale Ausrichtung der Kamera in Grad. Bereich [0, 360). 0 steht für Norden und 90 für Osten. |
pitchDegree |
Vertikale Ausrichtung der Kamera in Grad. Bereich [-90, 90]. 0 ist der Horizont, +90 ist senkrecht nach oben, -90 ist senkrecht nach unten. |
fovDegree |
Horizontales Sichtfeld in Grad. Bereich (0, 180]. Steuert die Zoomstufe. Ein kleineres Sichtfeld bedeutet mehr Zoom. |
ImageAnnotation
Eine Annotation auf einem Vorschaubild, z. B. ein Polygon, das einen Eingang umreißt.
| JSON-Darstellung |
|---|
{
"coordinates": [
{
object ( |
| Felder | |
|---|---|
coordinates[] |
Eine Liste von Koordinaten, die ein Polygon auf dem Bild bilden. Die Koordinaten sind gegen den Uhrzeigersinn sortiert. |
ImageAnnotation.Coordinate
Pixelkoordinate eines Punkts im Bild. Der Ursprung (0,0) ist die obere linke Ecke des oberen linken Pixels des Bildes, wobei die x-Achse nach rechts und die y-Achse nach unten zeigt.
| JSON-Darstellung |
|---|
{ "xPx": number, "yPx": number } |
| Felder | |
|---|---|
xPx |
X-Koordinate |
yPx |
Y-Koordinate |
Destination.ParkingOptions
Informationen zu Parkmöglichkeiten am Zielort.
| JSON-Darstellung |
|---|
{ "availability": enum ( |
| Felder | |
|---|---|
availability |
Die Verfügbarkeit von Parkplätzen für dieses Ziel. |
parkingFacilities[] |
Die Parkmöglichkeiten für dieses Ziel. |
onsiteParking |
Am Zielort stehen Parkplätze für Besucher/Kunden zur Verfügung. |
freeParkingLot |
Kostenlose Parkplätze sind vorhanden. |
paidParkingLot |
Gebührenpflichtige Parkplätze sind vorhanden. |
freeStreetParking |
Kostenlose Parkplätze an der Straße sind verfügbar. |
paidStreetParking |
Gebührenpflichtige Parkplätze an der Straße vorhanden |
valetParking |
Einparkservice vorhanden |
freeGarageParking |
Kostenlose Garagenparkplätze sind vorhanden. |
paidGarageParking |
Gebührenpflichtige Parkplätze im Parkhaus |
Destination.ParkingOptions.Availability
Ein aggregierter Wert, der angibt, wie schwierig es ist, einen Parkplatz zu finden, wenn man diesen Ort besucht.
In Zukunft werden möglicherweise neue Werte hinzugefügt.
| Enums | |
|---|---|
AVAILABILITY_UNSPECIFIED |
Es sind keine Informationen zur Verfügbarkeit von Parkplätzen vorhanden. |
PLENTY |
Es sind ausreichend Parkplätze vorhanden. |
SOMEWHAT_DIFFICULT |
Es ist eher schwierig, einen Parkplatz zu finden. |
DIFFICULT |
Es ist sehr schwierig, einen Parkplatz zu finden. |
Destination.ParkingOptions.ParkingFacility
Eine einzelne, separate Parkmöglichkeit (z.B. ein bestimmtes Parkhaus oder ein bestimmter Parkplatz), die mit dem Ziel verknüpft ist. Hier finden Sie detaillierte Informationen zu einer bestimmten Parkeinrichtung, während die übergeordnete ParkingOptions-Nachricht eine aggregierte Zusammenfassung aller verfügbaren Parkmöglichkeiten enthält.
| JSON-Darstellung |
|---|
{
"place": {
object ( |
| Felder | |
|---|---|
place |
Die Ortsdarstellung dieser bestimmten Parkeinrichtung. |
onsite |
Gibt an, ob sich diese Parkmöglichkeit am Hauptziel befindet. Wenn dieses Feld nicht festgelegt ist, ist der Status vor Ort unbekannt. |
popular |
Gibt an, ob diese Parkeinrichtung bei Besuchern, die zum Hauptziel reisen, beliebt ist. Wenn dieses Feld nicht festgelegt ist, ist der Beliebtheitsstatus unbekannt. |
straightLineDistanceMeters |
Die Luftlinie in Metern vom Hauptziel zu dieser Parkmöglichkeit. |
Destination.ArrivalSummary
KI-generierte Zusammenfassung der Ankunft am Zielort.
| JSON-Darstellung |
|---|
{ "text": { object ( |
| Felder | |
|---|---|
text |
Die Zusammenfassung der Ankunft am Zielort. |
flagContentUrl |
Ein Link, über den Nutzer ein Problem mit der Zusammenfassung melden können. |
disclosureText |
Nur Ausgabe. Enthält den Offenlegungstext für die Ankunftszusammenfassung. |