Geocoder-Klasse
google.maps.Geocoder
-Klasse
Ein Dienst zur Konvertierung zwischen einer Adresse und einer LatLng
.
Bei Verwendung von v=beta
kann über const {Geocoder} = await google.map.importLibrary("geocoding")
aufgerufen werden. Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.
Konstruktor | |
---|---|
Geocoder |
Geocoder() Parameter: Keine
Erstellt eine neue Instanz einer Geocoder , die Geocode-Anfragen an Google-Server sendet. |
Methoden | |
---|---|
geocode |
geocode(request[, callback]) Parameter:
Rückgabewert:
Promise<GeocoderResponse> Geocodieren einer Anforderung. |
GeocoderRequest
google.maps.GeocoderRequest
-Schnittstelle
Die Spezifikation für eine Geocoding-Anfrage, die an Geocoder
gesendet werden soll.
Attribute | |
---|---|
address optional |
Typ:
string optional Zu geocodierende Adresse Nur eine der folgenden Optionen muss angegeben werden: address , location und placeId . |
bounds optional |
Typ:
LatLngBounds|LatLngBoundsLiteral optional LatLngBounds , innerhalb derer gesucht werden soll. Optional. |
componentRestrictions optional |
Typ:
GeocoderComponentRestrictions optional Komponenten werden verwendet, um die Ergebnisse auf einen bestimmten Bereich zu beschränken. Ein Filter besteht aus einem oder mehreren der folgenden Filter: 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, falls 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 durch. Weitere Informationen finden Sie unter Umgekehrte Geocodierung. Nur eine der folgenden Optionen muss angegeben werden: address , location und placeId . |
placeId optional |
Typ:
string optional Die Orts-ID des Standorts. Eine Orts-ID ist eine eindeutige Kennzeichnung für einen Ort in der Google Places-Datenbank und in Google Maps. Weitere Informationen zu Orts-IDs finden Sie im Places API-Entwicklerleitfaden. Der Geocoder führt eine umgekehrte Geocodierung durch. Weitere Informationen finden Sie unter Umgekehrte Geocodierung. Nur eine der folgenden Optionen muss angegeben werden: address , location und placeId . |
region optional |
Typ:
string optional Ländercode zur Verzerrung der Suche, angegeben als zweistelliger (nicht numerischer) Subcode für die Unicode-Region / CLDR-Kennung. Optional. Informationen zu den unterstützten Regionen finden Sie unter Details zur Google Maps Platform-Abdeckung. |
Schnittstelle GeocoderComponentRestrictions
google.maps.GeocoderComponentRestrictions
-Schnittstelle
GeocoderComponentRestrictions
steht für eine Reihe von Filtern, die in einen bestimmten Bereich aufgelöst werden. Weitere Informationen zur Funktionsweise finden Sie unter Filter für Geocoding-Komponenten.
Attribute | |
---|---|
administrativeArea optional |
Typ:
string optional Stimmt mit allen administrative_area levels überein. Optional. |
country optional |
Typ:
string optional Entspricht einem Ländernamen oder einem aus zwei Buchstaben bestehenden ISO 3166-1-Ländercode. Optional. |
locality optional |
Typ:
string optional Übereinstimmung mit den Typen locality und sublocality . Optional. |
postalCode optional |
Typ:
string optional Stimmt mit postal_code und postal_code_prefix überein. Optional. |
route optional |
Typ:
string optional Entspricht dem langen oder kurzen Namen einer route . Optional. |
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
.
Bei Verwendung von v=beta
kann über const {GeocoderStatus} = await google.map.importLibrary("geocoding")
aufgerufen werden. Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.
Konstanten | |
---|---|
ERROR |
Bei der Verbindungsherstellung zu den Google-Servern ist ein Problem aufgetreten. |
INVALID_REQUEST |
GeocoderRequest war ungültig. |
OK |
Die Antwort enthält eine gültige 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 sie noch einmal ausführen. |
ZERO_RESULTS |
Für diese GeocoderRequest wurde kein Ergebnis gefunden. |
Schnittstelle GeocoderResponse
google.maps.GeocoderResponse
-Schnittstelle
Eine Geocoder-Antwort, die von Geocoder
zurückgegeben wird und die Liste der GeocoderResult
s enthält.
Attribute | |
---|---|
results |
Typ:
Array<GeocoderResult> Die Liste der GeocoderResult s. |
Schnittstelle GeocoderResult
google.maps.GeocoderResult
-Schnittstelle
Ein einzelnes Geocodierer-Ergebnis, das vom Geocode-Server abgerufen wurde. Eine Geocode-Anfrage kann mehrere Ergebnisobjekte zurückgeben. Beachten Sie, dass das Ergebnis „JSON-ähnlich“ ist, jedoch nicht ganz genau JSON entspricht, da es indirekt ein LatLng
-Objekt enthält.
Attribute | |
---|---|
address_components |
Ein Array mit GeocoderAddressComponent -Werten. |
formatted_address |
Typ:
string Ein String mit der für Menschen lesbaren Adresse dieses Standorts. |
geometry |
Typ:
GeocoderGeometry Ein GeocoderGeometry -Objekt |
place_id |
Typ:
string Die Orts-ID des Standorts. Eine Orts-ID ist eine eindeutige Kennzeichnung für einen Ort in der Google Places-Datenbank und in Google Maps. 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 Entwicklerleitfaden 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 lautet der Wert undefined . |
plus_code optional |
Typ:
PlacePlusCode optional Der Plus Code für den Standort. |
postcode_localities optional |
Typ:
Array<string> optional Ein String-Array, das alle Orte in einer Postleitzahl angibt. Das Array ist nur vorhanden, wenn das Ergebnis eine Postleitzahl mit mehreren Orten ist. |
GeocoderAddressComponent-Schnittstelle
google.maps.GeocoderAddressComponent
-Schnittstelle
Eine einzelne Adresskomponente innerhalb einer 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 String-Array, das den Typ dieser Adresskomponente angibt. Eine Liste der gültigen Typen finden Sie hier. |
Schnittstelle GeocoderGeometry
google.maps.GeocoderGeometry
-Schnittstelle
Geometrieinformationen zu diesem GeocoderResult
Attribute | |
---|---|
location |
Typ:
LatLng Die Breitengrad/Längengrad-Koordinaten dieses Ergebnisses. |
location_type |
Der Typ des in location zurückgegebenen Standorts |
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
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
.
Bei Verwendung von v=beta
kann über const {GeocoderLocationType} = await google.map.importLibrary("geocoding")
aufgerufen werden. Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.
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 zurückgegeben, wenn präzise Geocodes für eine Postanschrift nicht verfügbar sind. |
ROOFTOP |
Das zurückgegebene Ergebnis stellt eine präzise Geocodierung dar. |