Geocoder

Klasa Geocoder

google.maps.Geocoder zajęcia

Usługa służąca do konwertowania adresu z adresu na LatLng.

Aby uzyskać dostęp, zadzwoń pod numer const {Geocoder} = await google.maps.importLibrary("geocoding"). Zobacz Biblioteki w interfejsie Maps JavaScript API.
Geocoder
Geocoder()
Parametry: brak
Tworzy nową instancję Geocoder, która wysyła żądania geokodu na serwery Google.
geocode
geocode(request[, callback])
Parametry: 
Wartość zwrotu:  Promise<GeocoderResponse>
Geokoduj żądanie.

Interfejs GeocoderRequest

google.maps.GeocoderRequest interfejs

Specyfikacja żądania geokodowania wysyłanego do interfejsu Geocoder.
address optional
Typ:  string optional
Adres do geokodu. Należy podać tylko jedną wartość z tych elementów: address, location i placeId.
bounds optional
LatLngBounds, w którym można szukać. Opcjonalnie.
componentRestrictions optional
Komponenty służą do ograniczania wyników do konkretnego obszaru. Filtr składa się z co najmniej jednego z tych elementów: route, locality, administrativeArea, postalCode oraz country. Wyświetlone zostaną tylko wyniki pasujące do wszystkich filtrów. Wartości filtrów obsługują te same metody korekty pisowni i częściowego dopasowania co inne żądania geokodowania. Opcjonalnie.
language optional
Typ:  string optional
Identyfikator języka, w którym powinny być zwracane wyniki, jeśli to możliwe. Zobacz listę obsługiwanych języków.
location optional
Typ:  LatLng|LatLngLiteral optional
LatLng (lub LatLngLiteral), które mają zostać wyszukane. Geokoder przeprowadza odwrotny geokod. Więcej informacji znajdziesz w artykule na temat odwrotnego geokodowania. Należy podać tylko jedną wartość z tych elementów: address, location i placeId.
placeId optional
Typ:  string optional
Identyfikator miejsca powiązany z lokalizacją. Identyfikatory miejsc jednoznacznie identyfikują dane miejsce w bazie danych Miejsc Google i w Mapach Google. Więcej informacji o identyfikatorach miejsc znajdziesz w przewodniku dla programistów interfejsu Places API. Geokoder przeprowadza odwrotny geokod. Więcej informacji znajdziesz w artykule na temat odwrotnego geokodowania. Należy podać tylko jedną wartość z tych elementów: address, location i placeId.
region optional
Typ:  string optional
Kod kraju używany do promowania wyników wyszukiwania, określony za pomocą dwuznakowego (nienumerycznego) podtagu regionu Unicode lub identyfikatora CLDR. Opcjonalnie. Sprawdź szczegóły zasięgu Google Maps Platform, aby poznać obsługiwane regiony.

Interfejs GeocoderComponentRestrictions

google.maps.GeocoderComponentRestrictions interfejs

GeocoderComponentRestrictions to zestaw filtrów, które dotyczą określonego obszaru. Szczegółowe informacje o tym, jak to działa, znajdziesz w artykule Filtrowanie komponentów geokodowanych.
administrativeArea optional
Typ:  string optional
Pasuje do wszystkich administrative_area levels. Opcjonalnie.
country optional
Typ:  string optional
Zawiera nazwę kraju lub dwuliterowy kod kraju zgodny ze standardem ISO 3166-1. Opcjonalnie.
locality optional
Typ:  string optional
Dopasowania do typów locality i sublocality. Opcjonalnie.
postalCode optional
Typ:  string optional
Pasuje do postal_code i postal_code_prefix. Opcjonalnie.
route optional
Typ:  string optional
Dopasowuje długą lub krótką nazwę elementu route. Opcjonalnie.

Stałe GeocoderStatus

google.maps.GeocoderStatus stałe

Stan zwrócony przez Geocoder po zakończeniu wywołania do geocode(). Określ je według wartości lub nazwy stałej. np. 'OK' lub google.maps.GeocoderStatus.OK.

Aby uzyskać dostęp, zadzwoń pod numer const {GeocoderStatus} = await google.maps.importLibrary("geocoding"). Zobacz Biblioteki w interfejsie Maps JavaScript API.
ERROR Podczas nawiązywania połączenia z serwerami Google wystąpił problem.
INVALID_REQUEST Ta kolumna GeocoderRequest jest nieprawidłowa.
OK Odpowiedź zawiera prawidłowy atrybut GeocoderResponse.
OVER_QUERY_LIMIT Strona internetowa przekroczyła limit żądań w zbyt krótkim czasie.
REQUEST_DENIED Strona nie może korzystać z geokodera.
UNKNOWN_ERROR Nie udało się przetworzyć żądania geokodowania z powodu błędu serwera. Jeśli spróbujesz ponownie, żądanie może się powieść.
ZERO_RESULTS Nie znaleziono wyników dla tego urządzenia (GeocoderRequest).

Interfejs GeocoderResponse

google.maps.GeocoderResponse interfejs

Odpowiedź geokodera zwrócona przez interfejs Geocoder zawierająca listę elementów GeocoderResult.
results
Lista GeocoderResult.

Interfejs GeocoderResult

google.maps.GeocoderResult interfejs

Pojedynczy wynik geokodera pobrany z serwera geokodera. Żądanie geokodu może zwrócić wiele obiektów wyników. Pamiętaj, że chociaż ten wynik jest „podobny do JSON”, nie jest to tylko kod JSON, ponieważ pośrednio zawiera obiekt LatLng.
address_components
Tablica GeocoderAddressComponent
formatted_address
Typ:  string
Ciąg znaków zawierający zrozumiały dla człowieka adres tej lokalizacji.
geometry
Obiekt GeocoderGeometry
place_id
Typ:  string
Identyfikator miejsca powiązany z lokalizacją. Identyfikatory miejsc jednoznacznie identyfikują dane miejsce w bazie danych Miejsc Google i w Mapach Google. Więcej informacji na temat identyfikatorów miejsc znajdziesz w przewodniku dla programistów interfejsu Places API.
types
Typ:  Array<string>
Tablica ciągów oznaczających typ zwróconego geokodowanego elementu. Listę możliwych ciągów znaków znajdziesz w sekcji Typy komponentów adresu w przewodniku dla programistów.
partial_match optional
Typ:  boolean optional
Wskazuje, czy geokoder nie zwrócił dokładnego dopasowania do pierwotnego żądania, ale udało się dopasować część żądanego adresu. Jeśli dopasowanie jest ścisłe, wartość będzie równa undefined.
plus_code optional
Typ:  PlacePlusCode optional
Kod plus powiązany z lokalizacją.
postcode_localities optional
Typ:  Array<string> optional
Tablica ciągów oznaczających wszystkie miejscowości w kodzie pocztowym. Jest ona widoczna tylko wtedy, gdy wynik to kod pocztowy zawierający wiele miejscowości.

Interfejs GeocoderAddressComponent

google.maps.GeocoderAddressComponent interfejs

Pojedynczy komponent adresu w obiekcie GeocoderResult. Pełny adres może składać się z kilku elementów adresu.
long_name
Typ:  string
Pełny tekst komponentu adresu
short_name
Typ:  string
Skrócony, krótki tekst danego komponentu adresu
types
Typ:  Array<string>
Tablica ciągów oznaczających typ tego komponentu adresu. Listę prawidłowych typów znajdziesz tutaj.

Interfejs GeocoderGeometry

google.maps.GeocoderGeometry interfejs

Informacje geometryczne dotyczące obiektu GeocoderResult
location
Typ:  LatLng
Współrzędne szerokości i długości geograficznej tego wyniku
location_type
Typ lokalizacji zwrócony w funkcji location
viewport
Granice zalecanego widocznego obszaru do wyświetlania tego elementu (GeocoderResult)
bounds optional
Typ:  LatLngBounds optional
Dokładne granice tego parametru GeocoderResult (jeśli dotyczy)

Stałe GeocoderLocationType

google.maps.GeocoderLocationType stałe

Opisuje typ lokalizacji zwracanej z geokodu. Określ je według wartości lub nazwy stałej. np. 'ROOFTOP' lub google.maps.GeocoderLocationType.ROOFTOP.

Aby uzyskać dostęp, zadzwoń pod numer const {GeocoderLocationType} = await google.maps.importLibrary("geocoding"). Zobacz Biblioteki w interfejsie Maps JavaScript API.
APPROXIMATE Uzyskany wynik jest przybliżony.
GEOMETRIC_CENTER Uzyskany wynik to geometryczny środek takiego wyniku (np. ulicy) lub wielokąta (region).
RANGE_INTERPOLATED Zwrócony wynik odzwierciedla wartości przybliżone (zwykle na drodze) interpolowane między dwoma dokładnymi punktami (np. skrzyżowaniami). Wyniki interpolowane są zwykle zwracane, gdy geokody dachowe są niedostępne dla adresu.
ROOFTOP Uzyskany wynik odzwierciedla dokładny geokod.