Geocoder

Geocoder-Klasse

google.maps.Geocoder Kurs

Ein Dienst zum Umwandeln zwischen einer Adresse und einer LatLng.

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

GeocoderRequest-Schnittstelle

google.maps.GeocoderRequest Benutzeroberfläche

Die Spezifikation für eine Geocoding-Anfrage, die an den Geocoder gesendet werden soll.
address optional
Typ:string optional
Zu geocodierende Adresse Es muss genau eines von address, location und placeId angegeben werden.
bounds optional
LatLngBounds, in dem gesucht werden soll. Optional.
componentRestrictions optional
Mithilfe von Komponenten können Sie die Ergebnisse auf einen bestimmten Bereich eingrenzen. Ein Filter besteht aus einem oder mehreren der folgenden Werte: 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.
language optional
Typ:string optional
Eine Sprachkennzeichnung für die Sprache, in der die Ergebnisse zurückgegeben werden sollen, sofern möglich. Hier finden Sie eine Liste der unterstützten Sprachen.
location optional
Typ:LatLng|LatLngLiteral optional
LatLng (oder LatLngLiteral), nach dem gesucht werden soll. Der Geocoder führt eine umgekehrte Geocodierung aus. Weitere Informationen finden Sie unter Umgekehrte Geocodierung. Es muss genau eines von 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 Entwicklerhandbuch für die Places API. Der Geocoder führt eine umgekehrte Geocodierung aus. Weitere Informationen finden Sie unter Umgekehrte Geocodierung. Es muss genau eines von address, location und placeId angegeben werden.
region optional
Typ:string optional
Ländercode, mit dem die Suche beeinflusst wird, angegeben als zweistelliges (nicht numerisches) untergeordnetes Unicode-Tag für Regionen / CLDR-ID. Optional. Welche Regionen unterstützt werden, sehen Sie in den Details zur Google Maps Platform-Abdeckung.

GeocoderComponentRestrictions-Schnittstelle

google.maps.GeocoderComponentRestrictions Benutzeroberfläche

GeocoderComponentRestrictions steht für eine Reihe von Filtern, die auf einen bestimmten Bereich zurückzuführen sind. Weitere Informationen dazu finden Sie unter Filtern von Geocoding-Komponenten.
administrativeArea optional
Typ:string optional
Stimmt mit allen administrative_area levels überein. Optional.
country optional
Typ:string optional
Gleicht einem Ländernamen oder einem aus zwei Buchstaben bestehenden ISO 3166-1-Ländercode ab. Optional.
locality optional
Typ:string optional
Er entspricht sowohl locality- als auch sublocality-Typen. Optional.
postalCode optional
Typ:string optional
Entspricht postal_code und postal_code_prefix. Optional.
route optional
Typ:string optional
Gleicht dem langen oder Kurznamen einer route ab. Optional.

Konstanten für GeocoderStatus

google.maps.GeocoderStatus constants

Der Status, der von der Geocoder nach Abschluss eines Aufrufs von geocode() zurückgegeben wird. Geben Sie diese Werte anhand des Werts oder des Namens der Konstante an. Beispiel: 'OK' oder google.maps.GeocoderStatus.OK.

Rufe const {GeocoderStatus} = await google.maps.importLibrary("geocoding") auf, um auf die Daten zuzugreifen. 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 wurden keine Ergebnisse gefunden.

GeocoderResponse-Schnittstelle

google.maps.GeocoderResponse Benutzeroberfläche

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

GeocoderResult-Schnittstelle

google.maps.GeocoderResult Benutzeroberfläche

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 genommen JSON, da es indirekt ein LatLng-Objekt enthält.
address_components
Ein Array von GeocoderAddressComponents
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 möglicher Strings finden Sie im Entwicklerhandbuch im Abschnitt Adresskomponententypen.
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 mit dem Standort verknüpft 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.

GeocoderAddressComponent-Schnittstelle

google.maps.GeocoderAddressComponent Benutzeroberfläche

Eine einzelne Adresskomponente innerhalb einer GeocoderResult. Eine vollständige Adresse kann aus mehreren Adresskomponenten bestehen.
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, das den Typ dieser Adresskomponente angibt. Eine Liste der gültigen Typen finden Sie hier.

GeocoderGeometry-Schnittstelle

google.maps.GeocoderGeometry Benutzeroberfläche

Geometrische Informationen zu diesem GeocoderResult
location
Typ:LatLng
Die Breitengrad/Längengrad-Koordinaten dieses Ergebnisses.
location_type
Der in location zurückgegebene Standorttyp
viewport
Die Begrenzungen des empfohlenen Darstellungsbereichs für die Anzeige dieses GeocoderResult
bounds optional
Typ:LatLngBounds optional
Die genauen Grenzen dieser GeocoderResult, sofern zutreffend

Konstanten vom Typ GeocoderLocationType

google.maps.GeocoderLocationType constants

Beschreibt den Typ der Position, die nach einer Geocodierung zurückgegeben wird. Geben Sie diese Werte anhand des Werts oder des Namens der Konstante an. Beispiel: 'ROOFTOP' oder google.maps.GeocoderLocationType.ROOFTOP.

Rufe const {GeocoderLocationType} = await google.maps.importLibrary("geocoding") auf, um auf die Daten zuzugreifen. Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.
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.