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:
BetaextraComputations optional
Lista dodatkowych obliczeń, które mogą być użyte do wykonania żądania. Uwaga: te dodatkowe obliczenia mogą zwrócić dodatkowe pola w odpowiedzi.
fulfillOnZeroResults optional
Typ:  boolean optional
Spełnij obietnicę dotyczącą stanu ZERO_RESULT w odpowiedzi. Może to być pożądane, ponieważ nawet przy zerowym geokodowaniu mogą zostać zwrócone 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), 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:

ExtraGeocodeComputation: stałe

google.maps.ExtraGeocodeComputation stałe

Dodatkowe obliczenia do wykonania podczas realizacji żądania geokodowania.

Dostęp przez połączenie telefoniczne const {ExtraGeocodeComputation} = await google.maps.importLibrary("geocoding"). Zobacz Biblioteki w Maps JavaScript API.
ADDRESS_DESCRIPTORS wygenerować opis adresu;

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.
Betaaddress_descriptor optional
Typ:  AddressDescriptor optional
Relacyjny opis lokalizacji. Zawiera uporządkowany zestaw pobliskich punktów orientacyjnych i obszarów zawierających lokalizację docelową. Jest on wypełniany tylko w przypadku odwrotnego wyszukiwania informacji geograficznych i tylko wtedy, gdy włączona jest opcja ExtraGeocodeComputation.ADDRESS_DESCRIPTORS.
plus_code optional
Typ:  PlacePlusCode optional
Plus kod powiązany z lokalizacją.

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.
Betaaddress_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 zawierających lokalizację docelową. Będzie ono wypełniane tylko w przypadku zapytań o geokodowanie wprzód i wyszukiwania identyfikatorów miejsc 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ęść 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 AddressDescriptor

google.maps.AddressDescriptorinterfejs

Relacyjny opis lokalizacji. Zawiera uporządkowany zestaw pobliskich punktów orientacyjnych i obszarów zawierających lokalizację docelową.
areas
Typ:  Array<Area>
Posortowana lista obszarów zawierających lub sąsiadujących. Najbardziej przydatne (czyli rozpoznawalne i precyzyjne) obszary są klasyfikowane jako pierwsze.
landmarks
Typ:  Array<Landmark>
Posortowana lista pobliskich punktów orientacyjnych. Najbardziej przydatne (rozpoznawalne i znajdujące się w pobliżu) punkty orientacyjne są klasyfikowane jako pierwsze.

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.

Interfejs punktu orientacyjnego

google.maps.Landmarkinterfejs

Miejsce, które stanowi punkt odniesienia dla adresu.
display_name
Typ:  string
Nazwa punktu orientacyjnego.
display_name_language_code
Typ:  string
Język nazwy punktu orientacyjnego.
place_id
Typ:  string
Identyfikator miejsca, czyli obiektu, który jest punktem orientacyjnym. Może być używany do uzyskiwania dodatkowych informacji o danym punkcie orientacyjnym za pomocą funkcji Szczegóły miejsca lub Wyszukiwanie identyfikatora miejsca.
spatial_relationship
Określa relację przestrzenną między lokalizacją docelową a punktem orientacyjnym.
straight_line_distance_meters
Typ:  number
Odległość w prostej linii między lokalizacją docelową a punktem orientacyjnym.
types
Typ:  Array<string>
Co najmniej 1 wartość wskazująca typ zwróconego wyniku. Więcej informacji znajdziesz w sekcji Typy .
travel_distance_meters optional
Typ:  number optional
Odległość do pokonania wzdłuż sieci drogowej między lokalizacją docelową a punktem orientacyjnym. Może ona być pusta, jeśli punkt orientacyjny jest odłączony od części sieci drogowej, do której jest najbliżej, LUB jeśli docelowa lokalizacja nie jest faktycznie uważana za część sieci drogowej.

Interfejs Area

google.maps.Areainterfejs

Miejsce, które jest małym regionem, np. dzielnica, część miasta lub duży kompleks, w którym znajduje się lokalizacja docelowa.
containment
Określa relację przestrzenną między lokalizacją docelową a obszarem.
display_name
Typ:  string
Nazwa obszaru.
display_name_language_code
Typ:  string
Język nazwy obszaru.
place_id
Typ:  string
Identyfikator Miejsca w przypadku obszaru docelowego. Możesz go użyć, aby uzyskać więcej informacji o danym obszarze za pomocą funkcji Szczegóły miejsca lub Wyszukiwanie identyfikatora miejsca.

Ograniczenie stałe

google.maps.Containment stałe

Typ enumeracji reprezentujący relację przestrzenną między obszarem a miejscem docelowym.

Dostęp przez połączenie telefoniczne const {Containment} = await google.maps.importLibrary("geocoding"). Zobacz Biblioteki w Maps JavaScript API.
NEAR Miejsce docelowe znajduje się poza obszarem regionu, ale w pobliżu.
OUTSKIRTS Miejsce docelowe znajduje się w regionie obszaru, blisko krawędzi.
WITHIN Miejsce docelowe znajduje się w regionie obszaru, w pobliżu jego środka.

stałe SpatialRelationship

google.maps.SpatialRelationship stałe

Typ enumeracji reprezentujący relację w przestrzeni między punktem orientacyjnym a celem.

Dostęp przez połączenie telefoniczne const {SpatialRelationship} = await google.maps.importLibrary("geocoding"). Zobacz Biblioteki w Maps JavaScript API.
ACROSS_THE_ROAD Punkt docelowy znajduje się naprzeciwko punktu orientacyjnego po drugiej stronie drogi.
AROUND_THE_CORNER Nie na tej samej trasie co punkt orientacyjny, ale w odległości jednej skrętki.
BEHIND w pobliżu obiektu, ale dalej od punktu dostępu;
BESIDE Cel znajduje się bezpośrednio obok punktu orientacyjnego.
DOWN_THE_ROAD na tej samej trasie co punkt orientacyjny, ale nie obok niego ani naprzeciwko;
NEAR Jest to relacja domyślna, jeśli nie ma zastosowania żadna z poniżej wymienionych relacji.
WITHIN Punkt orientacyjny ma geometrię przestrzenną, a cel znajduje się w jej granicach.