Geocoder

Klasa Geocoder

google.maps.Geocoder zajęcia

Usługa konwertująca adres na LatLng i odwrotnie.

Dostęp przez połączenie pod numer const {Geocoder} = await google.maps.importLibrary("geocoding").
 Zobacz Biblioteki w Maps JavaScript API.

GeocoderRequest interfejs

google.maps.GeocoderRequestinterfejs

Specyfikacja żądania geokodowania, które ma zostać wysłane do Geocoder.

Właściwości
address optional	Typ:  string optional Adres do geokodowania. Należy podać tylko jedną z tych wartości: address, location lub placeId.
bounds optional	Typ:  LatLngBounds|LatLngBoundsLiteral optional LatLngBounds, w którym ma się odbyć wyszukiwanie. Opcjonalnie.
componentRestrictions optional	Typ:  GeocoderComponentRestrictions optional Komponenty 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. Wyświetlane będą tylko wyniki pasujące do wszystkich filtrów. Wartości filtrów obsługują te same metody korekty pisowni i dopasowania częściowego co inne żądania geokodowania. Opcjonalnie.
extraComputations optional	Typ:  Array<ExtraGeocodeComputation> optional Lista dodatkowych obliczeń, które mogą być użyte do zrealizowania żądania. Uwaga: te dodatkowe obliczenia mogą zwracać dodatkowe pola w odpowiedzi.
fulfillOnZeroResults optional	Typ:  boolean optional Spełnij obietnicę dotyczącą stanu ZERO_RESULT w odpowiedzi. Może to być przydatne, ponieważ nawet w przypadku braku wyników geokodowania mogą być zwracane dodatkowe pola na poziomie odpowiedzi.
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), które chcesz wyszukać. Geokoder wykonuje odwrotne geokodowanie. Więcej informacji znajdziesz w sekcji Geokodowanie zwrotne. Należy podać tylko jedną z tych 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 sekcji Geokodowanie zwrotne. Należy podać tylko jedną z tych wartości: address, location lub placeId.
region optional	Typ:  string optional Kod kraju używany do określania preferencji wyszukiwania. Jest to 2-znakowy (niecyfrowy) podtag regionu Unicode lub identyfikator CLDR. Opcjonalnie. Listę obsługiwanych regionów znajdziesz w szczegółach zasięgu Google Maps Platform.

GeocoderComponentRestrictions interfejs

google.maps.GeocoderComponentRestrictionsinterfejs

GeocoderComponentRestrictions reprezentuje zestaw filtrów, które wskazują konkretny obszar. Więcej informacji o tym, jak to działa, znajdziesz w artykule Filtrowanie komponentów geokodowania.

ExtraGeocodeComputation stałe

google.maps.ExtraGeocodeComputation stałe

Dodatkowe obliczenia do wykonania podczas realizacji prośby o geokodowanie.

Dostęp przez połączenie pod numer const {ExtraGeocodeComputation} = await google.maps.importLibrary("geocoding").
 Zobacz Biblioteki w Maps JavaScript API.

Stałe GeocoderStatus

google.maps.GeocoderStatus stałe

Stan zwrócony przez Geocoder po zakończeniu połączenia z numerem geocode(). Możesz je określić za pomocą wartości lub nazwy stałej. Na przykład 'OK' lub google.maps.GeocoderStatus.OK.

Dostęp przez połączenie pod numer const {GeocoderStatus} = await google.maps.importLibrary("geocoding").
 Zobacz Biblioteki w Maps JavaScript API.

GeocoderResponse interfejs

google.maps.GeocoderResponseinterfejs

Odpowiedź Geocodera zwrócona przez Geocoder zawierająca listę GeocoderResult.

Właściwości
results	Typ:  Array<GeocoderResult> Lista GeocoderResult.
address_descriptor optional	Typ:  AddressDescriptor optional Relacyjny opis lokalizacji. Zawiera uporządkowany zestaw pobliskich punktów orientacyjnych i obszarów, w których znajduje się lokalizacja docelowa. Jest wypełniana tylko w przypadku żądań geokodowania zwrotnego i tylko wtedy, gdy włączona jest opcja ExtraGeocodeComputation.ADDRESS_DESCRIPTORS.
plus_code optional	Typ:  PlacePlusCode optional Plus Code powiązany z lokalizacją.

GeocoderResult interfejs

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”, nie jest to ściśle JSON, ponieważ pośrednio zawiera obiekt LatLng.

Właściwości
address_components	Typ:  Array<GeocoderAddressComponent> Tablica wartości GeocoderAddressComponent
formatted_address	Typ:  string Ciąg tekstowy zawierający adres tej lokalizacji w formacie czytelnym dla człowieka.
geometry	Typ:  GeocoderGeometry 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ących typ zwróconego elementu geokodowanego. Listę możliwych ciągów znaków znajdziesz w sekcji Typy komponentów adresu w przewodniku dla programistów.
address_descriptor optional	Typ:  AddressDescriptor optional Relacyjny opis lokalizacji powiązanej z tym kodem geograficznym. Zawiera uporządkowany zestaw pobliskich punktów orientacyjnych i obszarów, w których znajduje się lokalizacja docelowa. To pole będzie wypełniane tylko w przypadku zapytań o geokodowanie do przodu i wyszukiwanie identyfikatora miejsca, tylko wtedy, gdy włączona jest opcja ExtraGeocodeComputation.ADDRESS_DESCRIPTORS, i tylko w przypadku niektórych zlokalizowanych miejsc.
partial_match optional	Typ:  boolean optional Czy geokoder nie zwrócił dokładnego dopasowania do pierwotnego żądania, ale udało mu się dopasować część żądanego adresu. Jeśli jest to dopasowanie ścisłe, wartość będzie wynosić undefined.
plus_code optional	Typ:  PlacePlusCode optional Plus Code powiązany z lokalizacją.
postcode_localities optional	Typ:  Array<string> optional Tablica ciągów znaków oznaczających wszystkie miejscowości zawarte w kodzie pocztowym. Jest to widoczne tylko wtedy, gdy wynikiem jest kod pocztowy obejmujący kilka miejscowości.

AddressDescriptor interfejs

google.maps.AddressDescriptorinterfejs

Relacyjny opis lokalizacji. Zawiera uporządkowany zestaw pobliskich punktów orientacyjnych i obszarów, w których znajduje się lokalizacja docelowa.

GeocoderAddressComponent interfejs

google.maps.GeocoderAddressComponentinterfejs

Pojedynczy komponent adresu w GeocoderResult. Pełny adres może składać się z wielu komponentów.