Geocoder

Klasa geokodera

google.maps.Geocoder class

Usługa konwertowania adresu na LatLng i odwrotnie.

Dostęp przez połączenie telefoniczne const {Geocoder} = await google.maps.importLibrary("geocoding"). Zobacz Biblioteki w Maps JavaScript API.
Geocoder
Geocoder()
Parametry: brak
Tworzy nową instancję Geocoder, która wysyła żądania geokodowania na serwery Google.
geocode
geocode(request[, callback])
Parametry: 
Wartość zwracana:  Promise<GeocoderResponse>
Zgeokoduj prośbę.

Interfejs GeocoderRequest

google.maps.GeocoderRequestinterfejs

Specyfikacja żądania geokodowania, które ma zostać wysłane do Geocoder.
address optional
Typ:  string optional
Adres do zakodowania. Musisz podać jedną z wartości address, location lub placeId.
bounds optional
LatLngBounds, w której chcesz przeprowadzić wyszukiwanie. Opcjonalnie:
componentRestrictions optional
Składniki służą do ograniczania wyników do określonego obszaru. Filtr składa się z co najmniej jednego z tych elementów: route, locality, administrativeArea, postalCode, country. Zwrócone zostaną tylko wyniki, które pasują do wszystkich filtrów. Wartości filtrów obsługują te same metody poprawiania pisowni i dopasowania częściowego co inne żądania geokodowania. Opcjonalnie:
language optional
Typ:  string optional
Identyfikator języka, w którym mają być zwracane wyniki (jeśli to możliwe). Zobacz listę obsługiwanych języków.
location optional
Typ:  LatLng|LatLngLiteral optional
LatLng (lub LatLngLiteral), w których chcesz przeprowadzić wyszukiwanie. Geokoder wykonuje odwrotne geokodowanie. Więcej informacji znajdziesz w artykule Geokodowanie odwrotne. Musisz podać jedną z wartości address, location lub placeId.
placeId optional
Typ:  string optional
Identyfikator miejsca powiązany z lokalizacją. Identyfikatory miejsc jednoznacznie identyfikują miejsce w bazie danych Miejsc Google i w Mapach Google. Więcej informacji o identyfikatorach miejsc znajdziesz w Przewodniku dla deweloperów interfejsu Places API. Geokoder wykonuje odwrotne geokodowanie. Więcej informacji znajdziesz w artykule Geokodowanie odwrotne. Musisz podać jedną z wartości address, location lub placeId.
region optional
Typ:  string optional
Kod kraju używany do ukierunkowania wyszukiwania, podany jako dwuznakowy (niecyfrowy) identyfikator regionu w Unicode lub identyfikator CLDR. Opcjonalnie: Więcej informacji o obsługiwanych regionach znajdziesz w szczegółach dotyczących zasięgu Google Maps Platform.

Interfejs GeocoderComponentRestrictions

google.maps.GeocoderComponentRestrictionsinterfejs

GeocoderComponentRestrictions to zbiór filtrów, które odnoszą się do konkretnego obszaru. Więcej informacji znajdziesz w artykule Filtrowanie komponentów geokodowania.
administrativeArea optional
Typ:  string optional
Pasuje do wszystkich administrative_area levels. Opcjonalnie:
country optional
Typ:  string optional
Pasuje do nazwy kraju lub dwuliterowego kodu kraju zgodnego ze standardem ISO 3166-1. Opcjonalnie:
locality optional
Typ:  string optional
Pasuje 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
odpowiada nazwie długiej lub krótkiej route. Opcjonalnie:

GeocoderStatus stałe

google.maps.GeocoderStatus stałe

Stan zwrócony przez Geocoder po zakończeniu wywołania geocode(). Określ je za pomocą wartości lub nazwy stałej. Na przykład 'OK' lub google.maps.GeocoderStatus.OK.

Dostęp przez połączenie telefoniczne const {GeocoderStatus} = await google.maps.importLibrary("geocoding"). Zobacz Biblioteki w Maps JavaScript API.
ERROR Wystąpił problem z kontaktem z serwerami Google.
INVALID_REQUEST Ten element GeocoderRequest jest nieprawidłowy.
OK Odpowiedź zawiera prawidłowy GeocoderResponse.
OVER_QUERY_LIMIT Strona przekroczyła limit żądań w zbyt krótkim czasie.
REQUEST_DENIED Strona internetowa nie może używać 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 żadnych wyników dla tego GeocoderRequest.

Interfejs GeocoderResponse

google.maps.GeocoderResponseinterfejs

Odpowiedź usługi Geocoder zwrócona przez Geocoder, zawierająca listę GeocoderResult.
results
Lista GeocoderResult.

Interfejs GeocoderResult

google.maps.GeocoderResultinterfejs

Pojedynczy wynik geokodowania pobrany z serwera geokodowania. Żądanie geokodowania może zwrócić wiele obiektów wyników. Pamiętaj, że chociaż ten wynik jest „podobny do JSON”, to nie jest to ściśle JSON, ponieważ pośrednio zawiera obiekt LatLng.
address_components
Tablica GeocoderAddressComponent
formatted_address
Typ:  string
Ciąg tekstowy zawierający adres tej lokalizacji w postaci zrozumiałej dla człowieka.
geometry
Obiekt GeocoderGeometry
place_id
Typ:  string
Identyfikator miejsca powiązany z lokalizacją. Identyfikatory miejsc jednoznacznie identyfikują miejsce w bazie danych Miejsc Google i w Mapach Google. Więcej informacji o identyfikatorach miejsc znajdziesz w Przewodniku dla deweloperów interfejsu Places API.
types
Typ:  Array<string>
Tablica ciągów znaków oznaczająca typ zwróconego elementu z dane geokodowane. Listę możliwych ciągów znaków znajdziesz w sekcji Typy elementów adresu w Przewodniku dla programistów.
partial_match optional
Typ:  boolean optional
czy geokoder nie zwrócił dokładnego dopasowania do pierwotnego żądania, ale udało mu się dopasować część adresu. W przypadku dopasowania ścisłego wartość będzie wynosić undefined.
plus_code optional
Typ:  PlacePlusCode optional
Plus kod powiązany z lokalizacją.
postcode_localities optional
Typ:  Array<string> optional
Tablica ciągów tekstowych oznaczających wszystkie miejscowości zawarte w kodzie pocztowym. Jest ona widoczna tylko wtedy, gdy wynik to kod pocztowy obejmujący wiele miejscowości.

Interfejs GeocoderAddressComponent

google.maps.GeocoderAddressComponentinterfejs

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

Interfejs GeocoderGeometry

google.maps.GeocoderGeometryinterfejs

Informacje o geometrii tego GeocoderResult
location
Typ:  LatLng
współrzędne geograficzne tego wyniku,
location_type
Typ lokalizacji zwracanej w parametry location
viewport
Granice zalecanego widocznego obszaru do wyświetlania tego GeocoderResult
bounds optional
Typ:  LatLngBounds optional
Dokładne granice tego elementu GeocoderResult (jeśli ma zastosowanie).

stałe GeocoderLocationType

google.maps.GeocoderLocationType stałe

Określa typ lokalizacji zwróconej przez geokodowanie. Określ je za pomocą wartości lub nazwy stałej. Na przykład 'ROOFTOP' lub google.maps.GeocoderLocationType.ROOFTOP.

Dostęp przez połączenie telefoniczne const {GeocoderLocationType} = await google.maps.importLibrary("geocoding"). Zobacz Biblioteki w Maps JavaScript API.
APPROXIMATE Zwrócony wynik jest przybliżony.
GEOMETRIC_CENTER Zwracany wynik to środek geometryczny wyniku, np.linii (np. ulicy) lub wielokąta (regionu).
RANGE_INTERPOLATED Zwracany wynik odzwierciedla przybliżenie (zwykle na drodze) interpolowane między 2 dokładnymi punktami (np. skrzyżowaniami). Interpolowane wyniki są zwracane, gdy kody geolokalizacji na dachu budynku są niedostępne dla adresu ulicznego.
ROOFTOP Zwrócony wynik odzwierciedla dokładny geokod.