Klasa Geocoder
google.maps.Geocoder
klasa
Usługa konwersji z adresu na LatLng
.
Jeśli używasz aplikacji v=beta
, możesz zadzwonić pod numer const {Geocoder} = await google.map.importLibrary("geocoding")
. Zobacz Biblioteki w interfejsie Maps JavaScript API.
Zespół | |
---|---|
Geocoder |
Geocoder() Parametry: brak
Tworzy nowe wystąpienie obiektu Geocoder , który wysyła żądania dotyczące danych geograficznych do serwerów Google. |
Metody | |
---|---|
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
.
Usługi | |
---|---|
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 |
Typ:
LatLngBounds|LatLngBoundsLiteral optional LatLngBounds w obrębie wyszukiwania. Opcjonalne. |
componentRestrictions optional |
Typ:
GeocoderComponentRestrictions 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. Opcjonalne. |
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. Opcjonalne. 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.
Usługi | |
---|---|
administrativeArea optional |
Typ:
string optional Pasuje do wszystkich elementów ( administrative_area levels ). Opcjonalne. |
country optional |
Typ:
string optional Jest zgodny z nazwą kraju lub dwuliterowym kodem kraju w formacie ISO 3166-1. Opcjonalne. |
locality optional |
Typ:
string optional Pasuje do locality i sublocality . Opcjonalne. |
postalCode optional |
Typ:
string optional Pasuje do postal_code i postal_code_prefix . Opcjonalne. |
route optional |
Typ:
string optional Odpowiada długiej lub krótkiej nazwie ( route ). Opcjonalne. |
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
.
Jeśli używasz aplikacji v=beta
, możesz zadzwonić pod numer const {GeocoderStatus} = await google.map.importLibrary("geocoding")
. Zobacz Biblioteki w interfejsie Maps JavaScript API.
Stałe | |
---|---|
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
.
Usługi | |
---|---|
results |
Typ:
Array<GeocoderResult> 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
.
Usługi | |
---|---|
address_components |
Tablica GeocoderAddressComponent |
formatted_address |
Typ:
string Ciąg zawierający adres tej lokalizacji w postaci zrozumiałej dla człowieka. |
geometry |
Typ:
GeocoderGeometry 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.
Usługi | |
---|---|
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
)
Usługi | |
---|---|
location |
Typ:
LatLng Szerokość i długość geograficzna tego wyniku |
location_type |
Typ:
GeocoderLocationType Typ lokalizacji zwróconej w: location |
viewport |
Typ:
LatLngBounds 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
.
Jeśli używasz aplikacji v=beta
, możesz zadzwonić pod numer const {GeocoderLocationType} = await google.map.importLibrary("geocoding")
. Zobacz Biblioteki w interfejsie Maps JavaScript API.
Stałe | |
---|---|
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ą. |