Method: geocode.destinations.searchDestinations

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

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 (NavigationPoint.TravelMode)
  ],
  "languageCode": string,
  "regionCode": string,

  // Union field primary_query can be only one of the following:
  "place": string,
  "addressQuery": {
    object (SearchDestinationsRequest.AddressQuery)
  },
  "locationQuery": {
    object (SearchDestinationsRequest.LocationQuery)
  }
  // End of list of possible types for union field primary_query.
}
Felder
travelModes[]

enum (NavigationPoint.TravelMode)

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

string

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

string

Optional. Regionscode. Der Regionscode, angegeben als zweistelliger Wert für die länderspezifische Top-Level-Domain (ccTLD). Der Parameter wirkt sich auf Ergebnisse aus, die auf dem anwendbaren Recht basieren. Durch diesen Parameter werden die Ergebnisse des Dienstes zwar beeinflusst, aber nicht vollständig eingeschränkt.

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 Zielgruppen werden auf Grundlage der angegebenen Primärabfrage erstellt.

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ärabfrage verwendet werden. Orte, die eine Ortschaft oder ein Verwaltungsgebiet darstellen, können jedoch nicht als Primärabfrage verwendet werden. Für primary_query ist nur einer der folgenden Werte zulässig:
place

string

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

object (SearchDestinationsRequest.AddressQuery)

Eine Adresse.
locationQuery

object (SearchDestinationsRequest.LocationQuery)

Ein genauer Standort.

Antworttext

Antwortnachricht für DestinationService.SearchDestinations.

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung 
{
  "destinations": [
    {
      object (Destination)
    }
  ]
}
Felder
destinations[]

object (Destination)

Eine Liste der Ziele.

Der Dienst gibt ein Ergebnis zurück, wenn ein primäres Ziel eindeutig aus der Primärabfrage 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-platform
  • https://www.googleapis.com/auth/maps-platform.geocode
  • https://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 
{

  // Union field kind can be only one of the following:
  "address": {
    object (PostalAddress)
  },
  "addressQuery": string
  // End of list of possible types for union field kind.
}
Felder
Union-Feld kind. Die Adressabfrage. Für kind ist nur einer der folgenden Werte zulässig:
address

object (PostalAddress)

Eine Adresse im Postanschriftformat.
addressQuery

string

Eine als einzelne Zeile formatierte Adresse.

SearchDestinationsRequest.LocationQuery

Eine Standortabfrage, um ein primäres Ziel in der Nähe zu ermitteln.

Hinweis: Wenn sich die Standortabfrage auf ein Gebäude mit Untergebäuden bezieht, 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 (SearchDestinationsRequest.LocationQuery.PlaceFilter)
  },

  // Union field kind can be only one of the following:
  "location": {
    object (LatLng)
  }
  // End of list of possible types for union field kind.
}
Felder
placeFilter

object (SearchDestinationsRequest.LocationQuery.PlaceFilter)

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

object (LatLng)

Ein genauer LatLng-Standort.

SearchDestinationsRequest.LocationQuery.PlaceFilter

Filter, die auf Zielkandidaten angewendet werden sollen.

JSON-Darstellung 
{
  "structureType": enum (PlaceView.StructureType),
  "addressability": enum (SearchDestinationsRequest.LocationQuery.PlaceFilter.Addressability)
}
Felder
structureType

enum (PlaceView.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 GROUNDS angegeben ist, haben alle zurückgegebenen Ziele einen primären Ort mit dem Strukturtyp GROUNDS. Dies kann dazu führen, dass einige Ziele, die nicht Teil eines Geländes sind, herausgefiltert werden oder dass die zurückgegebenen Ziele auf die Ebene des Geländes vergröbert werden.

Ein weiterer Anwendungsfall für dieses Feld ist das einfachere Extrahieren von Polygonen für die Darstellung von Gebäuden. Wenn beispielsweise BUILDING angegeben ist, ist das Anzeigepolygon des primären Orts für das Gebäude am angegebenen Standort.
addressability

enum (SearchDestinationsRequest.LocationQuery.PlaceFilter.Addressability)

Optional. Wenn angegeben, werden nur Ziele zurückgegeben, die die entsprechenden Kriterien für die Adressierbarkeit 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ätsgelände, 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 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 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 primäre Ort, zugehörige Orte, Eingänge und Navigationspunkte.

JSON-Darstellung 
{
  "primary": {
    object (PlaceView)
  },
  "containingPlaces": [
    {
      object (PlaceView)
    }
  ],
  "subDestinations": [
    {
      object (PlaceView)
    }
  ],
  "landmarks": [
    {
      object (Landmark)
    }
  ],
  "entrances": [
    {
      object (Entrance)
    }
  ],
  "navigationPoints": [
    {
      object (NavigationPoint)
    }
  ],
  "parkingOptions": {
    object (Destination.ParkingOptions)
  },
  "arrivalSummary": {
    object (Destination.ArrivalSummary)
  }
}
Felder
primary

object (PlaceView)

Der primäre Ort, der durch die primary_query in der Anfrage identifiziert wird.
containingPlaces[]

object (PlaceView)

Die weniger genauen Orte, in denen der primäre Ort enthalten ist. Beispiel: der Apartmentkomplex, zu dem dieses Gebäude gehört.
subDestinations[]

object (PlaceView)

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 der Unterziele umfassender und jedes Unterziel enthält mehr Informationen.
landmarks[]

object (Landmark)

Orientierungspunkte, die verwendet werden können, um zu kommunizieren, wo sich das Ziel befindet, oder um bei der Ankunft zu helfen.
entrances[]

object (Entrance)

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

object (NavigationPoint)

Navigationspunkte für dieses Ziel.
parkingOptions

object (Destination.ParkingOptions)

Parkmöglichkeiten für dieses Ziel.
arrivalSummary

object (Destination.ArrivalSummary)

KI-generierte Zusammenfassung der Ankunft am Zielort.

PlaceView

Stellt eine Ansicht eines Ortes 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 displayName zurückgegeben wird.

JSON-Darstellung 
{
  "place": string,
  "displayName": {
    object (LocalizedText)
  },
  "primaryType": string,
  "types": [
    string
  ],
  "formattedAddress": string,
  "postalAddress": {
    object (PostalAddress)
  },
  "structureType": enum (PlaceView.StructureType),
  "location": {
    object (LatLng)
  },
  "displayPolygon": {
    object
  },
  "addressComponents": [
    {
      object (PlaceView.AddressComponent)
    }
  ]
}
Felder
place

string

Der Ressourcenname dieses Orts im Format places/{placeId}. Kann zum Suchen des Orts verwendet werden.
placeId

string

Die eindeutige Kennung eines Ortes.
displayName

object (LocalizedText)

Menschenlesbare Beschreibung des Ortes. Beispiel: „Gate B“, „McDonalds“
primaryType

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 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

string

Eine Zeile für die Adresse.
postalAddress

object (PostalAddress)

Strukturierte Adresse.
structureType

enum (PlaceView.StructureType)

Der Typ des Gebäudes, das diesem Ort entspricht.
location

object (LatLng)

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

object (Struct format)

Die Polygonkontur 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 displayPolygon-Objekt kann also mehrere Polygone darstellen.
addressComponents[]

object (PlaceView.AddressComponent)

Wiederholte Komponenten für jede Lokalitätsebene.

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

string

Die Volltextbeschreibung oder der Name der Adresskomponente. Beispielsweise könnte eine Adresskomponente für das Land Australien den Langnamen „Australia“ haben.
shortText

string

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[]

string

Ein Array, das den Typ oder die Typen der Adresskomponente angibt.

Weitere Informationen finden Sie unter https://developers.google.com/maps/documentation/geocoding/requests-geocoding#Types.
languageCode

string

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 (LocalizedText)
  },
  "tags": [
    enum (Landmark.Tag)
  ],
  "straightLineDistanceMeters": number,
  "travelDistanceMeters": number,

  // Union field landmark can be only one of the following:
  "place": {
    object (PlaceView)
  }
  // End of list of possible types for union field landmark.
}
Felder
relationalDescription

object (LocalizedText)

Eine menschenlesbare Beschreibung, wie das Ziel mit dem Orientierungspunkt zusammenhängt. Beispiel: „In der Nähe des Empire State Building“ oder „Gegenüber dem Weißen Haus“.
tags[]

enum (Landmark.Tag)

Tags, die beschreiben, wie das Wahrzeichen im Kontext des Zielorts verwendet werden kann.
straightLineDistanceMeters

number

Nur Ausgabe. Die Luftlinie von dieser Sehenswürdigkeit zum Ziel in Metern.
travelDistanceMeters

number

Nur Ausgabe. Die Entfernung von diesem Orientierungspunkt zum Ziel in Metern.
Union-Feld landmark. Die Markierung. Für landmark ist nur einer der folgenden Werte zulässig:
place

object (PlaceView)

Der Ort, der dieses Wahrzeichen repräsentiert.

Landmark.Tag

Die Liste aller möglichen Tags, die beschreiben, wie ein Orientierungspunkt im Zusammenhang mit einem Ziel 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. Normalerweise 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. Das könnte beispielsweise ein Ort sein, der sich auf der gegenüberliegenden Straßenseite des Ziels befindet. Eine Sehenswürdigkeit mit diesem Tag liegt in der Regel näher am Ziel als Sehenswürdigkeiten 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 
{
  "location": {
    object (LatLng)
  },
  "tags": [
    enum (Entrance.Tag)
  ],
  "place": string,
  "streetViewThumbnail": {
    object (StreetViewThumbnail)
  },
  "streetViewAnnotation": {
    object (ImageAnnotation)
  }
}
Felder
location

object (LatLng)

Der Standort des Eingangs.
tags[]

enum (Entrance.Tag)

Eine Liste von Tags, die den Eingang beschreiben.
place

string

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

object (StreetViewThumbnail)

Street View-Miniaturansicht des Eingangs. 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

object (ImageAnnotation)

Anmerkung des Eingangs auf der oben zurückgegebenen streetViewThumbnail.

Entrance.Tag

Merkmale, die einen Eingang beschreiben.

Enums
TAG_UNSPECIFIED Nicht verwendet.
PREFERRED

Der Eingang bietet wahrscheinlich physischen Zugang zum Hauptort im 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 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 „Hauptteil“ des Gebäudes führen. In einem Einkaufszentrum sind die PREFERRED-Eingänge beispielsweise diejenigen, die den Zugang zum Hauptfoyer ermöglichen. 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.

StreetViewThumbnail

Parameter zum Darstellen 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

string

Eine bestimmte Panorama-ID.
widthPx

integer

Breite des ausgegebenen Vorschaubilds in Pixeln. Hinweis: Wenn Sie Anmerkungen zusammen mit dem Thumbnail anfordern, müssen diese Höhe- und Breitenwerte in der Street View API-Anfrage verwendet werden, damit die Anmerkungskoordinaten korrekt mit dem Bild übereinstimmen.
heightPx

integer

Höhe des ausgegebenen Vorschaubilds in Pixeln. Hinweis: Wenn Sie Anmerkungen zusammen mit dem Thumbnail anfordern, müssen diese Höhe- und Breitenwerte in der Street View API-Anfrage verwendet werden, damit die Anmerkungskoordinaten korrekt mit dem Bild übereinstimmen.
headingDegree

number

Horizontale Ausrichtung der Kamera in Grad. Bereich [0, 360). 0 steht für Norden und 90 für Osten.
pitchDegree

number

Vertikale Ausrichtung der Kamera in Grad. Bereich [-90, 90]. 0 ist der Horizont, +90 ist senkrecht nach oben, -90 ist senkrecht nach unten.
fovDegree

number

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 (ImageAnnotation.Coordinate)
    }
  ]
}
Felder
coordinates[]

object (ImageAnnotation.Coordinate)

Eine Liste von Koordinaten, die ein Polygon auf dem Bild bilden. Die Koordinaten sind gegen den Uhrzeigersinn geordnet.

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

number

X-Koordinate
yPx

number

Y-Koordinate

Destination.ParkingOptions

Informationen zu Parkmöglichkeiten am Zielort.

JSON-Darstellung 
{
  "availability": enum (Destination.ParkingOptions.Availability),
  "onsiteParking": boolean,
  "freeParkingLot": boolean,
  "paidParkingLot": boolean,
  "freeStreetParking": boolean,
  "paidStreetParking": boolean,
  "valetParking": boolean,
  "freeGarageParking": boolean,
  "paidGarageParking": boolean
}
Felder
availability

enum (Destination.ParkingOptions.Availability)

Die Verfügbarkeit von Parkplätzen für dieses Ziel.
onsiteParking

boolean

Am Zielort stehen Parkplätze für Besucher/Kunden zur Verfügung.
freeParkingLot

boolean

Kostenlose Parkplätze sind vorhanden.
paidParkingLot

boolean

Gebührenpflichtige Parkplätze sind vorhanden.
freeStreetParking

boolean

Parkplätze an der Straße sind kostenlos.
paidStreetParking

boolean

Gebührenpflichtige Parkplätze an der Straße sind vorhanden.
valetParking

boolean

Einparkservice verfügbar
freeGarageParking

boolean

Kostenlose Garagenparkplätze
paidGarageParking

boolean

Gebührenpflichtige Garagenparkplätze sind vorhanden.

Destination.ParkingOptions.Availability

Ein aggregierter Wert, der angibt, wie schwierig es ist, einen Parkplatz zu finden, wenn man diesen Ort besucht.

In Zukunft können neue Werte hinzugefügt werden.

Enums
AVAILABILITY_UNSPECIFIED Es sind keine Parkplätze verfügbar.
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.ArrivalSummary

KI‑generierte Zusammenfassung der Ankunft am Zielort.

JSON-Darstellung 
{
  "text": {
    object (LocalizedText)
  },
  "flagContentUrl": string,
  "disclosureText": {
    object (LocalizedText)
  }
}
Felder
text

object (LocalizedText)

Die Zusammenfassung der Ankunft am Zielort.
flagContentUrl

string

Ein Link, über den Nutzer ein Problem mit der Zusammenfassung melden können.
disclosureText

object (LocalizedText)

Nur Ausgabe. Enthält den Offenlegungstext für die Zusammenfassung der Ankunft.