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.
BetaextraComputations optional
Lista dodatkowych obliczeń, które mogą zostać użyte do realizacji żądania. Uwaga: te dodatkowe obliczenia mogą zwrócić dodatkowe pola w odpowiedzi.
fulfillOnZeroResults optional
Typ:  boolean optional
Spełnij obietnicę stanu ZERO_RESULT w odpowiedzi. Może to być przydatne, ponieważ nawet przy braku wyników geokodowania mogą nadal być zwracane dodatkowe pola na poziomie odpowiedzi.
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 ExtraGeocodeComputation

google.maps.ExtraGeocodeComputation stałe

Dodatkowe obliczenia do wykonania podczas realizacji żądania geokodowania.

Aby uzyskać dostęp, zadzwoń pod numer const {ExtraGeocodeComputation} = await google.maps.importLibrary("geocoding"). Zobacz Biblioteki w interfejsie Maps JavaScript API.
ADDRESS_DESCRIPTORS Wygeneruj deskryptor adresu.

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.
Betaaddress_descriptor optional
Typ:  AddressDescriptor optional
Relacyjny opis lokalizacji. Zawiera ranking punktów orientacyjnych i obszarów, w których znajduje się wybrana lokalizacja. Pole jest wypełniane tylko w przypadku żądań odwrotnego geokodowania i tylko wtedy, gdy włączona jest funkcja ExtraGeocodeComputation.ADDRESS_DESCRIPTORS.
plus_code optional
Typ:  PlacePlusCode optional
Kod plus powiązany z lokalizacją.

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.
Betaaddress_descriptor optional
Typ:  AddressDescriptor optional
Względny opis lokalizacji powiązanej z tym geokodem. Zawiera ranking punktów orientacyjnych i obszarów, w których znajduje się wybrana lokalizacja. Pole będzie wypełniane tylko w przypadku żądań geokodowania i wyszukiwania identyfikatorów miejsc, tylko jeśli włączono interfejs ExtraGeocodeComputation.ADDRESS_DESCRIPTORS, i tylko w przypadku niektórych zlokalizowanych miejsc.
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 AddressDescriptor

google.maps.AddressDescriptor interfejs

Relacyjny opis lokalizacji. Zawiera ranking punktów orientacyjnych i obszarów, w których znajduje się wybrana lokalizacja.
areas
Typ:  Array<Area>
Uporządkowana lista obszarów zawierających obszary lub przyległe obszary. W pierwszej kolejności znajdują się najbardziej przydatne (rozpoznawalne i precyzyjne) obszary.
landmarks
Typ:  Array<Landmark>
Uporządkowana lista punktów orientacyjnych w pobliżu. W pierwszej kolejności wyświetlają się najbardziej przydatne (rozpoznawalne i najbliższe) punkty orientacyjne.

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.

Interfejs punktu orientacyjnego

google.maps.Landmark interfejs

Miejsce, które jest punktem 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 będący obiektem używanym jako punkt orientacyjny. Można ich użyć do uzyskania dodatkowych informacji o punkcie orientacyjnym za pomocą szczegółów miejsca lub wyszukiwania identyfikatora miejsca.
spatial_relationship
Określa relację przestrzenną między lokalizacją docelową a punktem orientacyjnym.
straight_line_distance_meters
Typ:  number
Odległość w linii prostej między lokalizacją docelową a punktem orientacyjnym.
types
Typ:  Array<string>
Co najmniej jedna wartość wskazująca typ zwracanego wyniku. Więcej informacji znajdziesz w sekcji Typy .
travel_distance_meters optional
Typ:  number optional
Odległość w sieci drogowej między lokalizacją docelową a punktem orientacyjnym. To pole może nie być wypełniane, jeśli punkt orientacyjny jest odłączony od części sieci drogowej, od której znajduje się cel, LUB jeśli wybrana lokalizacja nie należy do sieci drogowej.

Interfejs obszaru

google.maps.Area interfejs

Miejsce to niewielki region, np. dzielnica, podrejon lub duży kompleks, który zawiera docelową lokalizację.
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 docelowego obszaru. Umożliwia znalezienie dodatkowych informacji o okolicy za pomocą szczegółów miejsca lub wyszukiwania identyfikatora miejsca.

Stałe kontenera

google.maps.Containment stałe

Wyliczenie reprezentujące relację przestrzenną między obszarem a lokalizacją docelową.

Aby uzyskać dostęp, zadzwoń pod numer const {Containment} = await google.maps.importLibrary("geocoding"). Zobacz Biblioteki w interfejsie Maps JavaScript API.
NEAR Wybrana lokalizacja znajduje się poza obszarem, ale w pobliżu.
OUTSKIRTS Docelowa lokalizacja znajduje się w regionie obszaru, blisko krawędzi.
WITHIN Wybrana lokalizacja znajduje się w regionie obszaru, w pobliżu centrum.

Stałe SpatialRelationship

google.maps.SpatialRelationship stałe

Wyliczenie reprezentujące relację w przestrzeni między punktem orientacyjnym a celem.

Aby uzyskać dostęp, zadzwoń pod numer const {SpatialRelationship} = await google.maps.importLibrary("geocoding"). Zobacz Biblioteki w interfejsie Maps JavaScript API.
ACROSS_THE_ROAD Cel znajduje się bezpośrednio naprzeciwko punktu orientacyjnego po drugiej stronie drogi.
AROUND_THE_CORNER Na tej samej trasie co punkt orientacyjny, tylko w jednym zakręcie.
BEHIND Znajduje się w pobliżu konstrukcji punktu orientacyjnego, ale dalej od jego punktu dostępu.
BESIDE Cel przylega bezpośrednio do punktu orientacyjnego.
DOWN_THE_ROAD Na tej samej trasie co punkt orientacyjny, ale nie poza nim ani po drugiej stronie.
NEAR Jest to relacja domyślna, w której nie mają zastosowania żadne bardziej szczegółowe informacje.
WITHIN Punkt orientacyjny ma geometrię przestrzenną, a cel mieści się w granicach.