Geocoder

Geocoder-Klasse

google.maps.Geocoder Klasse
Bibliothek "geocoding"

Ein Dienst zum Konvertieren zwischen einer Adresse und einem LatLng.

const {Geocoder} = await google.maps.importLibrary("geocoding");

Konstruktor
Geocoder	Geocoder() Parameter: Keine Erstellt eine neue Instanz von Geocoder, die Geocoding-Anfragen an Google-Server sendet.

Methoden
geocode	geocode(request[, callback]) Parameter: request: GeocoderRequest callback: function(Array<GeocoderResult> optional, GeocoderStatus): void optional Rückgabewert: Promise<GeocoderResponse> Geocodieren einer Anforderung.

GeocoderRequest-Schnittstelle

Schnittstelle google.maps.GeocoderRequest

Die Spezifikation für eine Geocoding-Anfrage, die an die Geocoder gesendet werden soll.

Attribute
address optional	Typ: string optional Zu geocodierende Adresse Es muss genau eine der folgenden Optionen angegeben werden: address, location oder placeId.
bounds optional	Typ: LatLngBounds|LatLngBoundsLiteral optional LatLngBounds, in dem gesucht werden soll. Optional.
componentRestrictions optional	Typ: GeocoderComponentRestrictions optional Mit Komponenten können Sie die Ergebnisse auf einen bestimmten Bereich eingrenzen. Ein Filter besteht aus einem oder mehreren der folgenden Elemente: route, locality, administrativeArea, postalCode, country. Es werden nur Ergebnisse zurückgegeben, die mit allen Filtern übereinstimmen. Die Filterwerte unterstützen dieselben Methoden für Rechtschreibkorrektur und partielle Übereinstimmung wie andere Geocoding-Anforderungen. Optional.
extraComputations optional	Hinweis: Nur in der v=Betaversion verfügbar. Typ: Array<ExtraGeocodeComputation> optional Eine Liste zusätzlicher Berechnungen, die zum Abschließen der Anfrage verwendet werden können. Hinweis: Diese zusätzlichen Berechnungen können zusätzliche Felder in der Antwort zurückgeben.
fulfillOnZeroResults optional	Typ: boolean optional Erfüllen Sie das Promise, wenn die Antwort den Status ZERO_RESULT hat. Das kann sinnvoll sein, weil auch ohne Geocoding-Ergebnisse zusätzliche Felder auf Antwortebene zurückgegeben werden können.
language optional	Typ: string optional Eine Sprachkennung für die Sprache, in der Ergebnisse nach Möglichkeit zurückgegeben werden sollen. Hier finden Sie eine Liste der unterstützten Sprachen.
location optional	Typ: LatLng|LatLngLiteral optional LatLng (oder LatLngLiteral), nach dem gesucht werden soll. Vom Geocoder wird eine umgekehrte Geocodierung ausgeführt. Weitere Informationen zur umgekehrten Geocodierung Es muss genau eine der folgenden Optionen angegeben werden: address, location oder placeId.
placeId optional	Typ: string optional Die Orts-ID, die dem Standort zugeordnet ist. Mit einer Orts-ID wird ein Ort in der Google Places-Datenbank und in Google Maps eindeutig identifiziert. Weitere Informationen zu Orts-IDs finden Sie im Entwicklerleitfaden für die Places API. Vom Geocoder wird eine umgekehrte Geocodierung ausgeführt. Weitere Informationen zur umgekehrten Geocodierung Es muss genau eine der folgenden Optionen angegeben werden: address, location oder placeId.
region optional	Typ: string optional Ländercode, der für die Suche verwendet wird, angegeben als zweistelliges (nicht numerisches) untergeordnetes Unicode-Tag für Regionen / CLDR-Kennung. Optional. Welche Regionen unterstützt werden, sehen Sie in den Details zur Google Maps Platform-Abdeckung.

GeocoderComponentRestrictions-Schnittstelle

Schnittstelle google.maps.GeocoderComponentRestrictions

GeocoderComponentRestrictions steht für eine Reihe von Filtern, die sich auf einen bestimmten Bereich beziehen. Weitere Informationen finden Sie unter Geocoding-Komponentenfilterung.

Attribute
administrativeArea optional	Typ: string optional Entspricht allen administrative_area levels. Optional.
country optional	Typ: string optional Gleicht einen Ländernamen oder einen aus 2 Buchstaben bestehenden ISO-3166-1-Ländercode ab. Optional.
locality optional	Typ: string optional Sucht nach einer Übereinstimmung mit den Typen locality und sublocality. Optional.
postalCode optional	Typ: string optional Entspricht postal_code und postal_code_prefix. Optional.
route optional	Typ: string optional Gleicht den langen oder den Kurznamen einer route ab. Optional.

ExtraGeocodeComputation-Konstanten

google.maps.ExtraGeocodeComputation Konstanten
Bibliothek "geocoding"

Hinweis: Nur in der v=Betaversion verfügbar.

Zusätzliche Berechnungen, die beim Ausführen einer Geocoding-Anfrage durchgeführt werden sollen.

Diese Konstanten können auch als Strings verwendet werden. In TypeScript werden die Stringliterale durch den Typ ExtraGeocodeComputationString definiert.

const {ExtraGeocodeComputation} = await google.maps.importLibrary("geocoding");

Konstanten
ADDRESS_DESCRIPTORS	Generieren Sie eine Adressbeschreibung.

GeocoderStatus-Konstanten

google.maps.GeocoderStatus Konstanten
Bibliothek "geocoding"

Der Status, der von Geocoder nach Abschluss eines Aufrufs von geocode() zurückgegeben wird. Geben Sie diese nach Wert oder mit dem Namen der Konstante an. Beispiel: 'OK' oder google.maps.GeocoderStatus.OK.

Diese Konstanten können auch als Strings verwendet werden. In TypeScript werden die Stringliterale durch den Typ GeocoderStatusString definiert.

const {GeocoderStatus} = await google.maps.importLibrary("geocoding");

Konstanten
ERROR	Beim Aufbau der Verbindung zu den Google-Servern ist ein Problem aufgetreten.
INVALID_REQUEST	Diese GeocoderRequest war ungültig.
OK	Die Antwort enthält ein gültiges GeocoderResponse.
OVER_QUERY_LIMIT	Die Anfragebeschränkungen wurden von der Webseite in einem zu geringen Zeitraum überschritten.
REQUEST_DENIED	Es ist der Webpage nicht gestattet, den Geocoder zu verwenden.
UNKNOWN_ERROR	Eine Geocodierungsanfrage konnte aufgrund eines Serverfehlers nicht verarbeitet werden. Die Anfrage ist möglicherweise erfolgreich, wenn Sie es erneut versuchen.
ZERO_RESULTS	Für diese GeocoderRequest wurde kein Ergebnis gefunden.

GeocoderResponse-Schnittstelle

Schnittstelle google.maps.GeocoderResponse

Eine Geocoder-Antwort, die vom Geocoder zurückgegeben wird und die Liste der GeocoderResults enthält.

Attribute
results	Typ: Array<GeocoderResult> Die Liste der GeocoderResults.
address_descriptor optional	Hinweis: Nur in der v=Betaversion verfügbar. Typ: AddressDescriptor optional Eine relationale Beschreibung eines Standorts. Enthält eine nach Rangfolge sortierte Liste von Sehenswürdigkeiten in der Nähe und die Gebiete, in denen sich der Zielort befindet. Es wird nur für Anfragen zur umgekehrten Geocodierung ausgefüllt und nur, wenn ExtraGeocodeComputation.ADDRESS_DESCRIPTORS aktiviert ist.
plus_code optional	Typ: PlacePlusCode optional Der Plus Code, der dem Standort zugeordnet ist.

GeocoderResult-Schnittstelle

Schnittstelle google.maps.GeocoderResult

Ein einzelnes Geocodierer-Ergebnis, das vom Geocode-Server abgerufen wurde. Eine Geocode-Anfrage kann mehrere Ergebnisobjekte zurückgeben. Dieses Ergebnis ist zwar „JSON-ähnlich“, aber nicht streng JSON, da es indirekt ein LatLng-Objekt enthält.

Attribute
address_components	Typ: Array<GeocoderAddressComponent> Ein Array von GeocoderAddressComponents
formatted_address	Typ: string Ein String, der die menschenlesbare Adresse dieses Ortes enthält.
geometry	Typ: GeocoderGeometry Ein GeocoderGeometry-Objekt
place_id	Typ: string Die Orts-ID, die dem Standort zugeordnet ist. Mit einer Orts-ID wird ein Ort in der Google Places-Datenbank und in Google Maps eindeutig identifiziert. Weitere Informationen zu Orts-IDs finden Sie im Entwicklerleitfaden für die Places API.
types	Typ: Array<string> Ein Array mit Zeichenfolgen, die die Typen der zurückgegebenen geocodierten Elemente bezeichnen. Eine Liste der möglichen Strings finden Sie im Abschnitt Typen von Adresskomponenten des Entwicklerhandbuchs.
address_descriptor optional	Hinweis: Nur in der v=Betaversion verfügbar. Typ: AddressDescriptor optional Eine relationale Beschreibung des Standorts, der mit diesem Geocode verknüpft ist. Enthält eine nach Rangfolge sortierte Liste von Sehenswürdigkeiten in der Nähe und die Gebiete, in denen sich der Zielort befindet. Dieses Feld wird nur für Anfragen zur Geocodierung und zur Suche nach Orts-IDs ausgefüllt, wenn ExtraGeocodeComputation.ADDRESS_DESCRIPTORS aktiviert ist, und nur für bestimmte lokalisierte Orte.
partial_match optional	Typ: boolean optional Gibt an, ob der Geocoder keine genaue Übereinstimmung für die ursprüngliche Anfrage zurückgegeben hat, obwohl ein Teil der angeforderten Adresse zugeordnet werden konnte. Bei einer genauen Übereinstimmung ist der Wert undefined.
plus_code optional	Typ: PlacePlusCode optional Der Plus Code, der dem Standort zugeordnet ist.
postcode_localities optional	Typ: Array<string> optional Ein Array von Strings, das alle Orte umfasst, die zu einer Postleitzahl gehören. Das Array ist nur vorhanden, wenn das Ergebnis eine Postleitzahl mit mehreren Orten ist.

AddressDescriptor-Schnittstelle

Schnittstelle google.maps.AddressDescriptor

Hinweis: Nur in der v=Betaversion verfügbar.

Eine relationale Beschreibung eines Standorts. Enthält eine nach Rangfolge sortierte Liste von Sehenswürdigkeiten in der Nähe und die Gebiete, in denen sich der Zielort befindet.

Attribute
areas	Typ: Array<Area> Eine nach Rang geordnete Liste der enthaltenen oder angrenzenden Gebiete. Die nützlichsten (erkennbaren und präzisen) Bereiche werden zuerst aufgeführt.
landmarks	Typ: Array<Landmark> Eine nach Rang geordnete Liste von Sehenswürdigkeiten in der Nähe. Die nützlichsten (bekanntesten und am nächsten gelegenen) Orientierungspunkte werden zuerst aufgeführt.

GeocoderAddressComponent-Schnittstelle

Schnittstelle google.maps.GeocoderAddressComponent

Eine einzelne Adresskomponente innerhalb eines GeocoderResult. Eine vollständige Adresse kann aus mehreren Adresskomponenten bestehen.

Attribute
long_name	Typ: string Der vollständige Text der Adresskomponente.
short_name	Typ: string Der abgekürzte Text der angegebenen Adresskomponente.
types	Typ: Array<string> Ein Array von Strings, die den Typ dieser Adresskomponente angeben. Eine Liste der gültigen Typen finden Sie hier.

GeocoderGeometry-Schnittstelle

Schnittstelle google.maps.GeocoderGeometry

Geometrische Informationen zu diesem GeocoderResult

Attribute
location	Typ: LatLng Die Breitengrad/Längengrad-Koordinaten dieses Ergebnisses.
location_type	Typ: GeocoderLocationType Der Typ des in location zurückgegebenen Orts
viewport	Typ: LatLngBounds Die Grenzen des empfohlenen Darstellungsbereichs für die Anzeige dieses GeocoderResult
bounds optional	Typ: LatLngBounds optional Die genauen Grenzen dieses GeocoderResult, falls zutreffend

GeocoderLocationType-Konstanten

google.maps.GeocoderLocationType Konstanten
Bibliothek "geocoding"

Beschreibt den Typ der Position, die nach einer Geocodierung zurückgegeben wird. Geben Sie diese nach Wert oder mit dem Namen der Konstante an. Beispiel: 'ROOFTOP' oder google.maps.GeocoderLocationType.ROOFTOP.

Diese Konstanten können auch als Strings verwendet werden. In TypeScript werden die Stringliterale durch den Typ GeocoderLocationTypeString definiert.

const {GeocoderLocationType} = await google.maps.importLibrary("geocoding");

Konstanten
APPROXIMATE	Das zurückgegebene Ergebnis ist ein Näherungswert.
GEOMETRIC_CENTER	Das zurückgegebene Ergebnis ist die geometrische Mitte eines Ergebnisses wie einer Linie (zum Beispiel einer Straße) oder eines Polygons (einer Region).
RANGE_INTERPOLATED	Das zurückgegebene Ergebnis stellt eine Näherung dar (normalerweise auf einer Straße), die zwischen zwei präzise lokalisierten Punkten (wie z. B. Kreuzungen) interpoliert wurde. Interpolierte Ergebnisse werden üblicherweise dann zurückgegeben, wenn hausnummern-genaue Geocodierungen für eine Adresse in einer Straße nicht zur Verfügung stehen.
ROOFTOP	Das zurückgegebene Ergebnis stellt eine präzise Geocodierung dar.

Landmark-Schnittstelle

Schnittstelle google.maps.Landmark

Hinweis: Nur in der v=Betaversion verfügbar.

Ein Ort, der als Referenzpunkt für die Adresse dient.

Attribute
display_name	Typ: string Der Name der Markierung.
display_name_language_code	Typ: string Die Sprache des Namens der Sehenswürdigkeit.
place_id	Typ: string Die Orts-ID der zugrunde liegenden Einrichtung, die als Orientierungspunkt dient. Kann verwendet werden, um über „Place Details“ oder „Orts-ID-Lookup“ weitere Informationen zur Sehenswürdigkeit abzurufen.
spatial_relationship	Typ: SpatialRelationship Definiert die räumliche Beziehung zwischen dem Zielort und der Sehenswürdigkeit.
straight_line_distance_meters	Typ: number Die Luftlinie zwischen dem Zielort und der Sehenswürdigkeit.
types	Typ: Array<string> Ein oder mehrere Werte, die den Typ des zurückgegebenen Ergebnisses angeben. Weitere Informationen finden Sie unter Typen .
travel_distance_meters optional	Typ: number optional Die Entfernung entlang des Straßennetzes zwischen dem Zielort und der Sehenswürdigkeit. Dieses Feld kann leer sein, wenn die Landmarke nicht mit dem Teil des Straßennetzes verbunden ist, der dem Ziel am nächsten liegt, ODER wenn der Zielort nicht als Teil des Straßennetzes betrachtet wurde.

Flächendiagramm-Schnittstelle

Schnittstelle google.maps.Area

Hinweis: Nur in der v=Betaversion verfügbar.

Ein Ort, der eine kleine Region ist, z. B. ein Stadtteil, ein Bezirk oder ein großer Komplex, der die Zielregion enthält.

Attribute
containment	Typ: Containment Definiert die räumliche Beziehung zwischen dem Zielort und dem Gebiet.
display_name	Typ: string Der Name des Bereichs.
display_name_language_code	Typ: string Die Sprache des Namens für das Gebiet.
place_id	Typ: string Die Orts-ID des zugrunde liegenden Gebiets. Kann verwendet werden, um über „Place Details“ oder „Orts-ID-Lookup“ weitere Informationen zum Gebiet abzurufen.

Containment-Konstanten

google.maps.Containment Konstanten
Bibliothek "geocoding"

Hinweis: Nur in der v=Betaversion verfügbar.

Ein Enum, das die räumliche Beziehung zwischen dem Bereich und der Zielregion darstellt.

Diese Konstanten können auch als Strings verwendet werden. In TypeScript werden die Stringliterale durch den Typ ContainmentString definiert.

const {Containment} = await google.maps.importLibrary("geocoding");

Konstanten
NEAR	Die Zielregion liegt außerhalb der Region, aber in der Nähe.
OUTSKIRTS	Die Zielregion befindet sich innerhalb der Region, nahe am Rand.
WITHIN	Die Zielregion befindet sich innerhalb der Region, nahe der Mitte.

SpatialRelationship-Konstanten

google.maps.SpatialRelationship Konstanten
Bibliothek "geocoding"

Hinweis: Nur in der v=Betaversion verfügbar.

Ein Enum, das die räumliche Beziehung zwischen der Landmarke und dem Ziel darstellt.

Diese Konstanten können auch als Strings verwendet werden. In TypeScript werden die Stringliterale durch den Typ SpatialRelationshipString definiert.

const {SpatialRelationship} = await google.maps.importLibrary("geocoding");

Konstanten
ACROSS_THE_ROAD	Das Ziel befindet sich direkt gegenüber der Sehenswürdigkeit auf der anderen Straßenseite.
AROUND_THE_CORNER	Nicht auf derselben Route wie die Landmarke, aber nur eine Abbiegung entfernt.
BEHIND	In der Nähe des Gebäudes, aber weiter entfernt vom Zugangspunkt.
BESIDE	Das Ziel befindet sich direkt neben der Sehenswürdigkeit.
DOWN_THE_ROAD	Auf derselben Route wie die Sehenswürdigkeit, aber nicht daneben oder gegenüber.
NEAR	Dies ist die Standardbeziehung, wenn keine der spezifischeren Beziehungen unten zutrifft.
WITHIN	Die Landmarke hat eine räumliche Geometrie und das Ziel befindet sich innerhalb ihrer Grenzen.