Geocoder

Geocoder-Klasse

google.maps.Geocoder Klasse

Ein Dienst zum Konvertieren zwischen einer Adresse und einer LatLng.

Zugriff durch Anrufen von const {Geocoder} = await google.maps.importLibrary("geocoding").
Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.
Geocoder
Geocoder()
Parameter:Keine
Erstellt eine neue Instanz von Geocoder, die Geocode-Anfragen an Google-Server sendet.
geocode
geocode(request[, callback])
Parameter:
Rückgabewert:Promise<GeocoderResponse>
Geocodieren einer Anforderung.

GeocoderRequest-Schnittstelle

google.maps.GeocoderRequest-Schnittstelle

Die Spezifikation für eine Geocoding-Anfrage, die an Geocoder gesendet werden soll.
address optional
Typ:string optional
Zu geocodierende Adresse Es muss genau einer der Werte address, location und placeId angegeben werden.
bounds optional
LatLngBounds, in dem gesucht werden soll. Optional.
componentRestrictions 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.
BetaextraComputations optional
Eine Liste zusätzlicher Berechnungen, die zum Ausführen der Anfrage verwendet werden können. Hinweis: Durch diese zusätzlichen Berechnungen können zusätzliche Felder in der Antwort zurückgegeben werden.
fulfillOnZeroResults optional
Typ:boolean optional
Führen Sie die Zusage bei einem ZERO_RESULT-Status in der Antwort aus. Das kann sinnvoll sein, da auch bei null Geocoding-Ergebnissen möglicherweise zusätzliche Felder auf Antwortebene zurückgegeben werden.
language optional
Typ:string optional
Eine Sprach-ID 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 einer der Werte address, location und placeId angegeben werden.
placeId optional
Typ:string optional
Die Orts-ID, die mit dem Standort verknüpft 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 einer der Werte address, location und placeId angegeben werden.
region optional
Typ:string optional
Der Ländercode, der verwendet wird, um die Suche zu beeinflussen. Er wird als zweistelliges (nicht numerisches) untergeordnetes Unicode-Tag für Regionen / CLDR-Kennung angegeben. Optional. Welche Regionen unterstützt werden, sehen Sie in den Details zur Google Maps Platform-Abdeckung.

GeocoderComponentRestrictions-Schnittstelle

google.maps.GeocoderComponentRestrictions-Schnittstelle

GeocoderComponentRestrictions steht für eine Reihe von Filtern, die in einem bestimmten Bereich aufgelöst werden. Weitere Informationen zur Funktionsweise finden Sie unter Geocoding-Komponenten filtern.
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 kurzen Namen eines route ab. Optional.

ExtraGeocodeComputation-Konstanten

google.maps.ExtraGeocodeComputation Konstanten

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

Zugriff durch Anrufen von const {ExtraGeocodeComputation} = await google.maps.importLibrary("geocoding").
Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.
ADDRESS_DESCRIPTORS Adressdeskriptor generieren

GeocoderStatus-Konstanten

google.maps.GeocoderStatus Konstanten

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.

Zugriff durch Anrufen von const {GeocoderStatus} = await google.maps.importLibrary("geocoding").
Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.
ERROR Beim Aufbau der Verbindung zu den Google-Servern ist ein Problem aufgetreten.
INVALID_REQUEST Dieses 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

google.maps.GeocoderResponse-Schnittstelle

Eine Geocoder-Antwort, die von Geocoder zurückgegeben wird und die Liste der GeocoderResults enthält.
results
Die Liste der GeocoderResults.
Betaaddress_descriptor optional
Typ:AddressDescriptor optional
Eine relationale Beschreibung eines Standorts. Enthält eine Liste der Sehenswürdigkeiten in der Nähe und der Gebiete, in denen sich der Zielort befindet. Sie wird nur für Reverse-Geocoding-Anfragen und nur dann ausgefüllt, wenn ExtraGeocodeComputation.ADDRESS_DESCRIPTORS aktiviert ist.
plus_code optional
Typ:PlacePlusCode optional
Der Plus Code, der dem Standort zugeordnet ist.

GeocoderResult-Schnittstelle

google.maps.GeocoderResult-Schnittstelle

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.
address_components
Ein Array von GeocoderAddressComponent
formatted_address
Typ:string
Ein String, der die Adresse dieses Ortes in visuell lesbarer Form enthält.
geometry
Ein GeocoderGeometry-Objekt
place_id
Typ:string
Die Orts-ID, die mit dem Standort verknüpft 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 im Entwicklerhandbuch.