Geocoder

Klasa Geocoder

google.maps.Geocoder klasa

Usługa konwersji z adresu na LatLng.

Zadzwoń pod numer const {Geocoder} = await google.maps.importLibrary("geocoding"). Zobacz Biblioteki w interfejsie Maps JavaScript API.
Geocoder
Geocoder()
Parametry: brak
Tworzy nowe wystąpienie obiektu Geocoder, który wysyła żądania dotyczące danych geograficznych do serwerów Google.
geocode
geocode(request[, callback])
Parametry: 
Zwrócona wartość:  Promise<GeocoderResponse>
Geokoduj żądanie.

Interfejs GeocoderRequest

google.maps.GeocoderRequest interfejs

Specyfikacja żądania geokodowania wysyłana do Geocoder.
address optional
Typ:  string optional
Adres do geokodowania. Należy podać tylko 1 z tych właściwości: address, location i placeId.
bounds optional
LatLngBounds w obrębie wyszukiwania. Opcjonalnie.
componentRestrictions optional
Komponenty służą do ograniczania wyników do określonego obszaru. Filtr składa się z co najmniej jednego filtra: route, locality, administrativeArea, postalCode i country. Zwrócone zostaną tylko wyniki pasujące 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 jest zwracany wynik (jeśli to możliwe). Zobacz listę obsługiwanych języków.
location optional
Typ:  LatLng|LatLngLiteral optional
LatLng (lub LatLngLiteral), dla których chcesz przeprowadzić wyszukiwanie. Geokoder obsługuje odwrotne kodowanie geograficzne. Więcej informacji znajdziesz w sekcji Odwrotne geokodowanie. Należy podać tylko 1 z tych właściwości: address, location i placeId.
placeId optional
Typ:  string optional
Identyfikator miejsca powiązany z lokalizacją. Identyfikatory miejsc jednoznacznie identyfikują miejsca w bazie danych Miejsc Google i w Mapach Google. Więcej informacji o identyfikatorach miejsc znajdziesz w przewodniku dla programistów korzystających z interfejsu Places API. Geokoder obsługuje odwrotne kodowanie geograficzne. Więcej informacji znajdziesz w sekcji Odwrotne geokodowanie. Należy podać tylko 1 z tych właściwości: address, location i placeId.
region optional
Typ:  string optional
Kod kraju używany do promowania stron wyników wyszukiwania, określony jako dwuznakowy (nieliczbowy) subtag regionu Unicode / identyfikator CLDR. Opcjonalnie. Listę obsługiwanych regionów znajdziesz w artykule Informacje o zasięgu Google Maps Platform.

Interfejs GeocoderComponentRestrictions

google.maps.GeocoderComponentRestrictions interfejs

GeocoderComponentRestrictions oznacza zestaw filtrów, które dotyczą określonego obszaru. Szczegółowe informacje na ten temat znajdziesz w artykule Filtrowanie komponentów geograficznych.
administrativeArea optional
Typ:  string optional
Pasuje do wszystkich elementów (administrative_area levels). Opcjonalnie.
country optional
Typ:  string optional
Jest zgodny z nazwą kraju lub dwuliterowym kodem kraju w formacie ISO 3166-1. Opcjonalnie.
locality optional
Typ:  string optional
Pasuje do locality i sublocality. Opcjonalnie.
postalCode optional
Typ:  string optional
Pasuje do postal_code i postal_code_prefix. Opcjonalnie.
route optional
Typ:  string optional
Odpowiada długiej lub krótkiej nazwie (route). Opcjonalnie.

stałe geokodera

google.maps.GeocoderStatus stałe

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

Zadzwoń pod numer const {GeocoderStatus} = await google.maps.importLibrary("geocoding"). Zobacz Biblioteki w interfejsie Maps JavaScript API.
ERROR Wystąpił problem z połączeniem z serwerami Google.
INVALID_REQUEST Ta wartość GeocoderRequest jest nieprawidłowa.
OK Odpowiedź zawiera prawidłowy element GeocoderResponse.
OVER_QUERY_LIMIT Strona przekroczyła limit żądań w krótkim czasie.
REQUEST_DENIED Strona internetowa nie może używać geokodera.
UNKNOWN_ERROR Nie można przetworzyć żądania geokodowania z powodu błędu serwera. Jeśli spróbujesz ponownie, prośba może się nie powieść.
ZERO_RESULTS Brak wyników dla: GeocoderRequest.

Interfejs GeocoderResponse

google.maps.GeocoderResponse interfejs

Odpowiedź geokodera zwrócona przez element Geocoder zawierający listę obiektów GeocoderResult.
results
Lista zasobów typu GeocoderResult.

Interfejs GeocoderResult

google.maps.GeocoderResult interfejs

Jeden wynik geokodowania pobrany z serwera geokodowania. Żądanie geokodowania może zwracać wiele wyników. Zwróć uwagę, że ten wynik jest „podobnie do JSON”, ale nie jest tylko JSON, ponieważ pośrednio zawiera obiekt LatLng.
address_components
Tablica GeocoderAddressComponent
formatted_address
Typ:  string
Ciąg 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ą miejsca w bazie danych Miejsc Google i w Mapach Google. Więcej informacji o identyfikatorach miejsc znajdziesz w przewodniku dla programistów korzystających z interfejsu Places API.
types
Typ:  Array<string>
Tablica ciągów znaków określających typ zwracanego elementu kodującego. Listę możliwych ciągów tekstowych znajdziesz w przewodniku dla programistów w sekcji Typy komponentów adresu.
partial_match optional
Typ:  boolean optional
Czy geokoder nie zwrócił ściśle dopasowania do pierwotnego żądania, mimo że mógł dopasować część żądanego adresu. Jeśli 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 oznaczających wszystkie miejscowości w kodzie pocztowym. Pojawia się tylko wtedy, gdy wynik jest kodem pocztowym obejmującym wiele miejscowości.

Interfejs GeocoderAddressComponent

google.maps.GeocoderAddressComponent interfejs

Pojedynczy komponent adresu w obrębie GeocoderResult. Pełny adres może składać się z wielu komponentów.
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 znaków określających typ tego komponentu adresu. Listę prawidłowych typów znajdziesz tutaj

Interfejs GeocoderGeometry

google.maps.GeocoderGeometry interfejs

Informacje geometryczne dotyczące tego elementu (GeocoderResult)
location
Typ:  LatLng
Szerokość i długość geograficzna tego wyniku
location_type
Typ lokalizacji zwróconej w: location
viewport
Granice zalecanego obszaru, w którym ma być wyświetlany ten element: GeocoderResult
bounds optional
Typ:  LatLngBounds optional
Dokładne granice tego obiektu GeocoderResult (w stosownych przypadkach).

Stałe typu GeocoderLocationType

google.maps.GeocoderLocationType stałe

Opisuje typ lokalizacji zwróconej z danych geograficznych. Określ je za pomocą wartości lub używając stałej wartości. na przykład 'ROOFTOP' lub google.maps.GeocoderLocationType.ROOFTOP.

Zadzwoń pod numer const {GeocoderLocationType} = await google.maps.importLibrary("geocoding"). Zobacz Biblioteki w interfejsie Maps JavaScript API.
APPROXIMATE Zwrócony wynik jest przybliżony.
GEOMETRIC_CENTER Zwracany wynik to geometryczny środek wyniku takiego wiersza (np. ulicy) lub wielokąta (regionu).
RANGE_INTERPOLATED Zwracany wynik odzwierciedla przybliżone (zwykle na drodze) interpolowane między 2 dokładnymi punktami (np. skrzyżowaniami). Interpolowane wyniki są zwykle zwracane, gdy geokodowanie na dachu jest niedostępne dla adresu pocztowego.
ROOFTOP Zwracany wynik odzwierciedla dokładną lokalizację geograficzną.