Geocoder

Klasa Geocoder

google.maps.Geocoder klasa
biblioteka "geocoding"

Usługa do konwersji adresu na LatLng i odwrotnie.

const {Geocoder} = await google.maps.importLibrary("geocoding");
Geocoder
Geocoder()
Parametry: brak
Tworzy nową instancję Geocoder, która wysyła żądania geokodowania do serwerów Google.
geocode
geocode(request[, callback])
Parametry:
Wartość zwracana: Promise<GeocoderResponse>
geokodować żądanie,

Interfejs GeocoderRequest

Interfejs google.maps.GeocoderRequest

Specyfikacja żądania geokodowania, które ma zostać wysłane do Geocoder.
address
opcjonalne
Typ: string optional
Adres do geokodowania. Należy podać tylko jedną z tych wartości: address, location lub placeId.
bounds
opcjonalne
LatLngBounds, w którym ma zostać przeprowadzone wyszukiwanie. Opcjonalnie:
componentRestrictions
opcjonalne
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. Zwracane są tylko wyniki, które pasują 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
opcjonalne
Lista dodatkowych obliczeń, które mogą być użyte do realizacji żądania. Uwaga: te dodatkowe obliczenia mogą zwracać dodatkowe pola w odpowiedzi.
fulfillOnZeroResults
opcjonalne
Typ: boolean optional
Spełnij obietnicę dotyczącą stanu ZERO_RESULT w odpowiedzi. Może to być pożądane, ponieważ nawet przy braku wyników geokodowania mogą być zwracane dodatkowe pola na poziomie odpowiedzi.
language
opcjonalne
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
opcjonalne
Typ: LatLng|LatLngLiteral optional
LatLng (lub LatLngLiteral), którego szukasz. Geokoder wykonuje odwrotne geokodowanie. Więcej informacji znajdziesz w artykule Odwrotne geokodowanie. Należy podać tylko jedną z tych wartości: address, location lub placeId.
placeId
opcjonalne
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 programistów dotyczącym Places API. Geokoder wykonuje odwrotne geokodowanie. Więcej informacji znajdziesz w artykule Odwrotne geokodowanie. Należy podać tylko jedną z tych wartości: address, location lub placeId.
region
opcjonalne
Typ: string optional
Kod kraju używany do ukierunkowania wyszukiwania, określony jako dwuznakowy (nienumeryczny) podtag regionu Unicode lub identyfikator CLDR. Opcjonalnie: Obsługiwane regiony znajdziesz w artykule Szczegóły dotyczące zasięgu Google Maps Platform.

Interfejs GeocoderComponentRestrictions

Interfejs google.maps.GeocoderComponentRestrictions

GeocoderComponentRestrictions reprezentuje zestaw filtrów, które wskazują konkretny obszar. Szczegółowe informacje o tym, jak to działa, znajdziesz w sekcji Filtrowanie komponentów geokodowania.
administrativeArea
opcjonalne
Typ: string optional
Pasuje do wszystkich administrative_area levels. Opcjonalnie:
country
opcjonalne
Typ: string optional
Dopasowuje nazwę kraju lub dwuliterowy kod kraju zgodny ze standardem ISO 3166-1. Opcjonalnie:
locality
opcjonalne
Typ: string optional
Dopasowuje do typów locality i sublocality. Opcjonalnie:
postalCode
opcjonalne
Typ: string optional
Pasuje do: postal_code i postal_code_prefix. Opcjonalnie:
route
opcjonalne
Typ: string optional
Dopasowuje długą lub krótką nazwę route. Opcjonalnie:

Stałe ExtraGeocodeComputation

google.maps.ExtraGeocodeComputation stałe
biblioteka "geocoding"

Dodatkowe obliczenia do wykonania podczas realizacji żądania geokodowania.

Te stałe mogą być też używane jako ciągi znaków. W języku TypeScript literały ciągów znaków są definiowane przez typ ExtraGeocodeComputationString.

const {ExtraGeocodeComputation} = await google.maps.importLibrary("geocoding");
ADDRESS_DESCRIPTORS Wygeneruj deskryptor adresu.

Stałe GeocoderStatus

google.maps.GeocoderStatus stałe
biblioteka "geocoding"

Stan zwracany przez Geocoder po zakończeniu wywołania geocode(). Możesz je określić za pomocą wartości lub nazwy stałej. Na przykład 'OK' lub google.maps.GeocoderStatus.OK.

Te stałe mogą być też używane jako ciągi znaków. W języku TypeScript literały ciągów znaków są definiowane przez typ GeocoderStatusString.

const {GeocoderStatus} = await google.maps.importLibrary("geocoding");
ERROR Wystąpił problem z połączeniem z serwerami Google.
INVALID_REQUEST Ten element (GeocoderRequest) był nieprawidłowy.
OK Odpowiedź zawiera prawidłowy element GeocoderResponse.
OVER_QUERY_LIMIT Strona internetowa 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 zostać zrealizowane.
ZERO_RESULTS Nie znaleziono wyników dla tego GeocoderRequest.

Interfejs GeocoderResponse

Interfejs google.maps.GeocoderResponse

Odpowiedź geokodera zwrócona przez Geocoder zawierająca listę GeocoderResult.
results
Lista elementów typu GeocoderResult.
Betaaddress_descriptor
opcjonalne
Typ: AddressDescriptor optional
Opis lokalizacji w odniesieniu do innych miejsc. Zawiera uporządkowany zestaw pobliskich punktów orientacyjnych i obszarów, na których znajduje się docelowa lokalizacja. Jest wypełniane tylko w przypadku żądań odwrotnego geokodowania i tylko wtedy, gdy włączona jest opcja ExtraGeocodeComputation.ADDRESS_DESCRIPTORS.
plus_code
opcjonalne
Typ: PlacePlusCode optional
Plus code powiązany z lokalizacją.

Interfejs GeocoderResult

Interfejs google.maps.GeocoderResult

Pojedynczy wynik geokodera pobrany z serwera geokodowania. Żądanie geokodowania może zwrócić wiele obiektów wynikowych. Zwróć uwagę, że chociaż ten wynik jest „podobny do JSON”, nie jest to ściśle JSON, ponieważ pośrednio zawiera obiekt LatLng.
address_components
Tablica obiektów GeocoderAddressComponent
formatted_address
Typ: string
Ciąg tekstowy 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ą miejsce w bazie danych Miejsc Google i w Mapach Google. Więcej informacji o identyfikatorach miejsc znajdziesz w przewodniku dla programistów korzystających z Places API.
types
Typ: Array<string>
Tablica ciągów znaków określających typ zwróconego elementu z kodem geograficznym. Listę możliwych ciągów znaków znajdziesz w sekcji Typy komponentów adresu w Przewodniku dla programistów.
Betaaddress_descriptor
opcjonalne
Typ: AddressDescriptor optional
Opis relacyjny lokalizacji powiązanej z tym kodem geograficznym. Zawiera uporządkowany zestaw pobliskich punktów orientacyjnych i obszarów, na których znajduje się wybrana lokalizacja. To pole będzie wypełniane tylko w przypadku żądań geokodowania i wyszukiwania identyfikatora miejsca, tylko wtedy, gdy włączona jest opcja ExtraGeocodeComputation.ADDRESS_DESCRIPTORS, i tylko w przypadku niektórych miejsc zlokalizowanych.
partial_match
opcjonalne
Typ: boolean optional
Czy geokoder nie zwrócił dopasowania ścisłego do pierwotnego żądania, mimo że udało mu się dopasować część żądanego adresu. W przypadku dopasowania ścisłego wartość będzie wynosić undefined.
plus_code
opcjonalne
Typ: PlacePlusCode optional
Plus code powiązany z lokalizacją.
postcode_localities
opcjonalne
Typ: Array<string> optional
Tablica ciągów znaków oznaczających wszystkie miejscowości zawarte w kodzie pocztowym. Ten element jest obecny tylko wtedy, gdy wynik jest kodem pocztowym, który zawiera wiele miejscowości.

Interfejs AddressDescriptor

Interfejs google.maps.AddressDescriptor

Opis lokalizacji w odniesieniu do innych miejsc. Zawiera uporządkowany zestaw pobliskich punktów orientacyjnych i obszarów, na których znajduje się docelowa lokalizacja.
areas
Typ: Array<Area>
Uporządkowana lista obszarów zawierających lub przylegających. Najbardziej przydatne (rozpoznawalne i precyzyjne) obszary są wyświetlane na początku.
landmarks
Ranking punktów orientacyjnych w pobliżu. Najbardziej przydatne (rozpoznawalne i znajdujące się w pobliżu) punkty orientacyjne są wyświetlane na początku.

Interfejs GeocoderAddressComponent

Interfejs google.maps.GeocoderAddressComponent

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

Interfejs GeocoderGeometry

Interfejs google.maps.GeocoderGeometry

Informacje o geometrii tego elementu: GeocoderResult
location
Typ: LatLng
Współrzędne szerokości i długości geograficznej tego wyniku.
location_type
Typ lokalizacji zwrócony w polu location.
viewport
Granice zalecanego obszaru wyświetlania tego elementu: GeocoderResult
bounds
opcjonalne
Typ: LatLngBounds optional
Dokładne granice tego elementu (GeocoderResult), jeśli ma zastosowanie

Stałe GeocoderLocationType

google.maps.GeocoderLocationType stałe
biblioteka "geocoding"

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

Te stałe mogą być też używane jako ciągi znaków. W języku TypeScript literały ciągów znaków są definiowane przez typ GeocoderLocationTypeString.

const {GeocoderLocationType} = await google.maps.importLibrary("geocoding");
APPROXIMATE Zwrócony wynik jest przybliżony.
GEOMETRIC_CENTER Zwrócony wynik to geometryczny środek wyniku, np.linii (np. ulicy) lub wielokąta (regionu).
RANGE_INTERPOLATED Zwrócony wynik odzwierciedla przybliżoną lokalizację (zwykle na drodze) interpolowaną między 2 dokładnymi punktami (np. skrzyżowaniami). Wyniki interpolowane są zwykle zwracane, gdy kody geograficzne dachu są niedostępne dla adresu ulicy.
ROOFTOP Zwrócony wynik odzwierciedla dokładny kod geograficzny.

Interfejs punktu orientacyjnego

Interfejs google.maps.Landmark

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, w którym znajduje się obiekt będący punktem orientacyjnym. Można go użyć, aby uzyskać więcej informacji o punkcie orientacyjnym za pomocą funkcji informacje o miejscu lub Wyszukiwanie identyfikatora miejsca.
spatial_relationship
Definiuje relację przestrzenną między lokalizacją docelową a punktem orientacyjnym.
straight_line_distance_meters
Typ: number
Odległość w linii prostej między wybraną lokalizacją 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
opcjonalne
Typ: number optional
Odległość między wybraną lokalizacją a punktem orientacyjnym mierzona wzdłuż sieci dróg. To pole może być puste, jeśli punkt orientacyjny jest odłączony od części sieci drogowej, do której cel jest najbliżej, LUB jeśli lokalizacja docelowa nie została uznana za znajdującą się w sieci drogowej.

Interfejs obszaru

Interfejs google.maps.Area

Miejsce, które jest małym regionem, np. dzielnicą, mniejszą miejscowością lub dużym kompleksem, który zawiera docelową lokalizację.
containment
Definiuje 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żna go użyć, aby uzyskać więcej informacji o obszarze za pomocą funkcji informacje o miejscu lub Wyszukiwanie identyfikatora miejsca.

Stałe ograniczenia

google.maps.Containment stałe
biblioteka "geocoding"

Typ wyliczeniowy reprezentujący relację przestrzenną między obszarem a lokalizacją docelową.

Te stałe mogą być też używane jako ciągi znaków. W języku TypeScript literały ciągów znaków są definiowane przez typ ContainmentString.

const {Containment} = await google.maps.importLibrary("geocoding");
NEAR Lokalizacja docelowa znajduje się poza obszarem, ale w pobliżu.
OUTSKIRTS Lokalizacja docelowa znajduje się w regionie, blisko krawędzi.
WITHIN Wybrana lokalizacja znajduje się w obrębie regionu, blisko jego środka.

Stałe SpatialRelationship

google.maps.SpatialRelationship stałe
biblioteka "geocoding"

Typ wyliczeniowy reprezentujący relację w przestrzeni między punktem orientacyjnym a miejscem docelowym.

Te stałe mogą być też używane jako ciągi znaków. W języku TypeScript literały ciągów znaków są definiowane przez typ SpatialRelationshipString.

const {SpatialRelationship} = await google.maps.importLibrary("geocoding");
ACROSS_THE_ROAD Cel 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 jednego skrętu.
BEHIND blisko struktury punktu orientacyjnego, ale dalej od jego 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 domyślna relacja, gdy nie ma zastosowania żadna z poniższych bardziej szczegółowych relacji.
WITHIN Punkt orientacyjny ma geometrię przestrzenną, a cel znajduje się w jego granicach.