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.
Geocoder
Geocoder()
Parametry: brak
Tworzy nową instancję Geocoder, która wysyła żądania geokodowania na serwery Google.
geocode
geocode(request[, callback])
Parametry: 
Zwracana wartość:  Promise<GeocoderResponse>
Geokodowanie żądania.

GeocoderRequest interfejs

google.maps.GeocoderRequestinterfejs

Specyfikacja żądania geokodowania, które ma zostać wysłane do Geocoder.
address optional
Typ:  string optional
Adres do geokodowania. Należy podać tylko jedną z tych wartości: address, location lub placeId.
bounds optional
LatLngBounds, w którym ma się odbyć wyszukiwanie. Opcjonalnie.
componentRestrictions 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.
BetaextraComputations 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.
administrativeArea optional
Typ:  string optional
Pasuje do wszystkich znaków administrative_area levels. Opcjonalnie.
country optional
Typ:  string optional
Pasuje do nazwy kraju lub dwuliterowego kodu kraju w standardzie 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
Wyświetla route o długiej lub krótkiej nazwie. Opcjonalnie.

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.
ADDRESS_DESCRIPTORS Wygeneruj opis adresu.

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.
ERROR Podczas nawiązywania połączenia z serwerami Google wystąpił problem.
INVALID_REQUEST Ten nagłówek GeocoderRequest jest nieprawidłowy.
OK Odpowiedź zawiera prawidłowy GeocoderResponse.
OVER_QUERY_LIMIT Strona internetowa przekroczyła limit żądań w zbyt krótkim czasie.
REQUEST_DENIED Strona 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 wyników dla tego GeocoderRequest.

GeocoderResponse interfejs

google.maps.GeocoderResponseinterfejs

Odpowiedź Geocodera 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, 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.
address_components
Tablica wartości GeocoderAddressComponent
formatted_address
Typ:  string
Ciąg tekstowy zawierający adres tej lokalizacji w formacie czytelnym 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ą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.
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, 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.
areas
Typ:  Array<Area>
Lista zawierająca obszary, w których znajduje się wyszukiwane miejsce lub które z nim sąsiadują, posortowana według rankingu. Najbardziej przydatne (rozpoznawalne i precyzyjne) obszary są wymienione na początku.
landmarks
Typ:  Array<Landmark>
Lista pobliskich punktów orientacyjnych posortowana według odległości. Najbardziej przydatne (rozpoznawalne i znajdujące się w pobliżu) punkty orientacyjne są wyświetlane na początku listy.

GeocoderAddressComponent interfejs

google.maps.GeocoderAddressComponentinterfejs

Pojedynczy komponent adresu w 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 tekst danego komponentu adresu.
types
Typ:  Array<string>
Tablica ciągów znaków oznaczających typ tego komponentu adresu. Listę prawidłowych typów znajdziesz tutaj.

GeocoderGeometry interfejs

google.maps.GeocoderGeometryinterfejs

Informacje o geometrii tego GeocoderResult
location
Typ:  LatLng
Współrzędne geograficzne szerokości i długości tego wyniku
location_type
Typ lokalizacji zwrócony w location
viewport
Granice zalecanego widocznego obszaru do wyświetlania tego GeocoderResult
bounds optional
Typ:  LatLngBounds optional
Dokładne granice tego elementu GeocoderResult (w stosownych przypadkach).

Stałe GeocoderLocationType

google.maps.GeocoderLocationType stałe

Opisuje typ lokalizacji zwróconej przez geokodowanie. Możesz je określić za pomocą wartości lub nazwy stałej. Na przykład 'ROOFTOP' lub google.maps.GeocoderLocationType.ROOFTOP.

Dostęp przez połączenie pod numer 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 Zwrócony wynik odzwierciedla przybliżenie (zwykle na drodze) interpolowane między 2 precyzyjnymi punktami (np. skrzyżowaniami). Wyniki interpolowane są zwykle zwracane, gdy w przypadku adresu ulicy nie są dostępne geokody dachu.
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 bazowego obiektu, który służy jako punkt orientacyjny. Może służyć do uzyskiwania dodatkowych informacji o 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 linii prostej 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ść dojazdu po sieci dróg między lokalizacją docelową a punktem orientacyjnym. To pole może być puste, jeśli punkt orientacyjny jest odłączony od części sieci drogowej, do której docelowe miejsce jest najbliżej, LUB jeśli docelowa lokalizacja nie została uznana za znajdującą się w sieci drogowej.

Interfejs Area

google.maps.Areainterfejs

Miejsce, które jest małym regionem, np. dzielnicą, podregionem lub dużym kompleksem, 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 obszaru bazowego. Może służyć do uzyskiwania dodatkowych informacji o obszarze za pomocą funkcji Szczegóły miejsca lub Wyszukiwanie identyfikatora miejsca.

Stałe zawierające

google.maps.Containment stałe

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

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

Stałe SpatialRelationship

google.maps.SpatialRelationship stałe

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

Dostęp przez połączenie pod numer const {SpatialRelationship} = await google.maps.importLibrary("geocoding").
 Zobacz Biblioteki w Maps JavaScript API.
ACROSS_THE_ROAD Cel znajduje się bezpośrednio naprzeciwko punktu orientacyjnego po drugiej stronie drogi.
AROUND_THE_CORNER Nie na tej samej trasie co punkt orientacyjny, ale w odległości jednego skrętu.
BEHIND Blisko 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 nie po drugiej stronie.
NEAR Jest to domyślna relacja, gdy nie ma zastosowania żadna z poniższych.
WITHIN Punkt orientacyjny ma geometrię przestrzenną, a cel znajduje się w jego granicach.