Package google.maps.geocode.v4alpha

Indeks

DestinationService

Usługa do pobierania miejsc docelowych.

Miejsce docelowe zapewnia kontekst hierarchiczny dotyczący miejsca, co umożliwia na przykład znajdowanie budynków mieszkalnych w większym kompleksie apartamentów i odwrotnie. Zawiera też punkty nawigacyjne odpowiednie do zastosowań takich jak wspólne przejazdy czy dostawy.

SearchDestinations

rpc SearchDestinations(SearchDestinationsRequest) returns (SearchDestinationsResponse)

Ta metoda wyszukuje miejsca docelowe i zwraca ich listę.

Zakresy autoryzacji

Wymaga jednego z tych zakresów OAuth:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/maps-platform.geocode

GeocodeService

Usługa do geokodowania.

GeocodeAddress

rpc GeocodeAddress(GeocodeAddressRequest) returns (GeocodeAddressResponse)

Ta metoda wykonuje geokodowanie adresu, które mapuje adres na obiekt LatLng. Zawiera też uporządkowane informacje o adresie.

Zakresy autoryzacji

Wymaga jednego z tych zakresów OAuth:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/maps-platform.geocode
  • https://www.googleapis.com/auth/maps-platform.geocode.address
GeocodeLocation

rpc GeocodeLocation(GeocodeLocationRequest) returns (GeocodeLocationResponse)

Ta metoda wykonuje geokodowanie lokalizacji, które mapuje obiekt LatLng na adres. Zawiera też uporządkowane informacje o adresie.

Zakresy autoryzacji

Wymaga jednego z tych zakresów OAuth:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/maps-platform.geocode
  • https://www.googleapis.com/auth/maps-platform.geocode.location
GeocodePlace

rpc GeocodePlace(GeocodePlaceRequest) returns (GeocodeResult)

Ta metoda wyszukuje kod geograficzny za pomocą identyfikatora miejsca.

Zakresy autoryzacji

Wymaga jednego z tych zakresów OAuth:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/maps-platform.geocode
  • https://www.googleapis.com/auth/maps-platform.geocode.place

Miejsce docelowe

miejsce docelowe; Obejmuje to główne miejsce, powiązane miejsca, wejścia i punkty nawigacyjne.

Pola
primary

PlaceView

Główne miejsce zidentyfikowane przez parametr primary_query w żądaniu.
containing_places[]

PlaceView

Mniej precyzyjne miejsca, w których znajduje się miejsce główne. Na przykład kompleks apartamentów, w którym znajduje się ten budynek.
sub_destinations[]

PlaceView

Dokładniejsze podrzędne miejsca docelowe w miejscu głównym. Na przykład jednostki znajdujące się w budynku.

Uwaga: w porównaniu z SubDestination zwracanym przez interfejs Places API ta lista miejsc docelowych jest bardziej wyczerpująca, a każde miejsce docelowe zawiera więcej informacji.
landmarks[]

Landmark

Punkty orientacyjne, które można wykorzystać do przekazania informacji o miejscu docelowym lub ułatwienia dotarcia do niego.
entrances[]

Entrance

Wejścia do tego miejsca docelowego.
navigation_points[]

NavigationPoint

Punkty nawigacyjne dla tego miejsca docelowego.
arrival_summary

Destination.ArrivalSummary

Podsumowanie wygenerowane przez AI dotyczące wrażeń po przyjeździe do miejsca docelowego.

ArrivalSummary

Podsumowanie wygenerowane przez AI dotyczące wrażeń po przyjeździe do miejsca docelowego.

Pola
text

LocalizedText

Podsumowanie wrażeń po przyjeździe do miejsca docelowego.
flag_content_url

string

Link, za pomocą którego użytkownicy mogą zgłosić problem ze streszczeniem.
disclosure_text

LocalizedText

Tylko dane wyjściowe. Zawiera tekst informacji o podsumowaniu przyjazdu.

Wejście

Wejście to pojedyncza para współrzędnych szerokości i długości geograficznej, która określa lokalizację punktu wejścia i wyjścia w danym miejscu.

Pola
location

LatLng

Lokalizacja wejścia.
tags[]

Entrance.Tag

Lista tagów opisujących wejście.
place

string

Struktura, na której znajduje się to wejście, w formacie places/{place_id}.

Tag

Cechy opisujące wejście.

Wartości w polu enum
TAG_UNSPECIFIED Nie używane.
PREFERRED

Wejście prawdopodobnie zapewnia fizyczny dostęp do głównego miejsca w zwróconym miejscu docelowym. Miejsce może mieć wiele preferowanych wejść. Jeśli wejście nie ma tego tagu, oznacza to, że znajduje się w tym samym budynku co główne miejsce, ale niekoniecznie zapewnia do niego dostęp.

Jeśli na przykład głównym miejscem jest restauracja w centrum handlowym, wejścia „PREFEROWANE” będą prawdopodobnie prowadzić do samej restauracji, a pozostałe zwrócone wejścia będą innymi wejściami do budynku, np. do innych restauracji w centrum handlowym.

Jeśli głównym miejscem jest sam budynek, PREFERRED wejścia będą prowadzić do „głównej” części budynku. Na przykład w centrum handlowym wejścia PREFERRED to te, które umożliwiają dostęp do głównego holu, ale jeśli wejście zapewnia dostęp tylko do sklepu z boku budynku, nie będzie to wejście PREFERRED.

Uwaga: PREFERRED wejście może nie zapewniać dostępu do głównego miejsca, a wejście bez oznaczenia PREFERRED może zapewniać dostęp do głównego miejsca.

GeocodeAddressRequest

Komunikat żądania dla GeocodeService.GeocodeAddress.

Pola
location_bias

GeocodeAddressRequest.LocationBias

Opcjonalnie. Region, w którym ma się odbywać wyszukiwanie. Ta lokalizacja służy jako punkt odniesienia, co oznacza, że mogą być zwracane wyniki w jej pobliżu.
language_code

string

Opcjonalnie. Język, w którym mają być zwracane wyniki.
region_code

string

Opcjonalnie. Kod regionu. Kod regionu określony jako 2-znakowa wartość ccTLD („domena najwyższego poziomu”). Ten parametr wpływa na wyniki na podstawie obowiązujących przepisów. Ten parametr będzie też wpływać na wyniki z usługi, ale nie będzie ich w pełni ograniczać.
Pole zbiorcze address_input. Adres do geokodowania. address_input może mieć tylko jedną z tych wartości:
address_query

string

Nieuporządkowany adres do geokodowania.
address

PostalAddress

Uporządkowany adres do geokodowania w formacie adresu pocztowego.

LocationBias

Region, w którym ma się odbywać wyszukiwanie. Ta lokalizacja służy jako punkt odniesienia, co oznacza, że mogą być zwracane wyniki w jej pobliżu.

Pola
Pole zbiorcze type. Rodzaje odchyleń związanych z lokalizacją. type może mieć tylko jedną z tych wartości:
rectangle

Viewport

Prostokąt określony przez narożniki północno-wschodni i południowo-zachodni. rectangle.high() musi być punktem północno-wschodnim prostokątnego obszaru widocznego. rectangle.low() musi być południowo-zachodnim punktem prostokątnego obszaru widocznego. Wartość rectangle.low().latitude() nie może być większa niż rectangle.high().latitude(). Spowoduje to powstanie pustego zakresu szerokości geograficznej. Prostokątny obszar widoku nie może być szerszy niż 180 stopni.

GeocodeAddressResponse

Wiadomość z odpowiedzią dla GeocodeService.GeocodeAddress.

Pola
results[]

GeocodeResult

Wynik geokodowania.

GeocodeLocationRequest

Wiadomość z prośbą o wywołanie GeocodeService.GeocodeLocation.

Pola
language_code

string

Opcjonalnie. Język, w którym mają być zwracane wyniki.
region_code

string

Opcjonalnie. Kod regionu. Kod regionu określony jako 2-znakowa wartość ccTLD („domena najwyższego poziomu”). Ten parametr wpływa na wyniki na podstawie obowiązujących przepisów.
types[]

string

Opcjonalnie. Zestaw tagów typu, które ograniczają wyniki. Wyniki, które nie mają żadnego z określonych typów, zostaną usunięte.

Pełną listę możliwych wartości znajdziesz w tabelach A i B na stronie https://developers.google.com/maps/documentation/places/web-service/place-types.
granularity[]

GeocodeResult.Granularity

Opcjonalnie. Filtr zawierający co najmniej 1 wartość wyliczeniową określającą poziom szczegółowości lokalizacji.
Pole zbiorcze location_input. Lokalizacja do geokodowania. location_input może mieć tylko jedną z tych wartości:
location_query

string

Lokalizacja w formacie „lat,lng”. Na przykład „64.7611872,-18.4705364”.
location

LatLng

Lokalizacja w formacie strukturalnym.

GeocodeLocationResponse

Wiadomość z odpowiedzią dla GeocodeService.GeocodeLocation.

Pola
results[]

GeocodeResult

Wynik geokodowania.
plus_code

PlusCode

Plus kod lokalizacji w żądaniu.

GeocodePlaceRequest

Wiadomość z prośbą o wywołanie GeocodeService.GeocodePlace.

Pola
place

string

Wymagane. Identyfikator miejsca do geokodowania w formacie places/{place}.
language_code

string

Opcjonalnie. Język, w którym mają być zwracane wyniki.
region_code

string

Opcjonalnie. Kod regionu. Kod regionu określony jako 2-znakowa wartość ccTLD („domena najwyższego poziomu”). Ten parametr wpływa na wyniki na podstawie obowiązujących przepisów.

GeocodeResult

Wynik geokodowania zawiera informacje geograficzne o miejscu.

Pola
place

string

W przypadku tego wyniku w pełni kwalifikowany identyfikator miejsca. W formacie „//places.googleapis.com/places/{placeID}”. Więcej informacji znajdziesz na stronie https://developers.google.com/maps/documentation/places/web-service/place-id.
place_id

string

Identyfikator miejsca dla tego wyniku.
location

LatLng

Współrzędne geograficzne tego adresu.
granularity

GeocodeResult.Granularity

Stopień szczegółowości lokalizacji.
viewport

Viewport

Obszar widoczny odpowiedni do wyświetlenia wyniku geokodowania.
bounds

Viewport

Pole ograniczenia adresu.
formatted_address

string

Jednowierszowy sformatowany adres.
postal_address

PostalAddress

Adres w formacie adresu pocztowego.
address_components[]

GeocodeResult.AddressComponent

Powtarzające się komponenty dla każdego poziomu lokalizacji.
postal_code_localities[]

LocalizedText

Pełna lista miejscowości w danym kodzie pocztowym.

To pole jest wypełniane tylko wtedy, gdy wynik jest typu „postal_code”.
types[]

string

Zestaw tagów typu dla tego wyniku. Na przykład „political” i „administrative_area”.

Pełną listę możliwych wartości znajdziesz w tabelach A i B na stronie https://developers.google.com/maps/documentation/places/web-service/place-types.
plus_code

PlusCode

Kod Plus Code lokalizacji w tym geokodzie.

AddressComponent

Uporządkowane komponenty, które tworzą sformatowany adres, jeśli te informacje są dostępne.

Pola
long_text

string

Pełny tekst opisu lub nazwa komponentu adresu. Na przykład komponent adresu dla kraju Australia może mieć długą nazwę „Australia”.
short_text

string

Skrócona nazwa tekstowa komponentu adresu, jeśli jest dostępna. Na przykład komponent adresu dla Australii może mieć krótką nazwę „AU”.
types[]

string

Tablica wskazująca typy komponentu adresu.

Więcej informacji znajdziesz na stronie https://developers.google.com/maps/documentation/geocoding/requests-geocoding#Types.
language_code

string

Język używany do formatowania tego komponentu w notacji CLDR.

Szczegółowość

Stopień szczegółowości lokalizacji.

Wartości w polu enum
GRANULARITY_UNSPECIFIED Nie używać.
ROOFTOP Nieinterpolowana lokalizacja rzeczywistej działki odpowiadająca dopasowanemu adresowi.
RANGE_INTERPOLATED Interpolowane z zakresu numerów ulic. Jeśli np. wiemy, że odcinek Amphitheatre Pkwy zawiera numery od 1600 do 1699, numer 1650 może znajdować się w połowie odległości między jego punktami końcowymi.
GEOMETRIC_CENTER Geometryczne centrum obiektu, dla którego mamy dane wielokątne.
APPROXIMATE Wszystkie pozostałe.

Punkt orientacyjny

Punkty orientacyjne służą do określania miejsca docelowego lub ułatwiają dotarcie do niego.

Pola
relational_description

LocalizedText

Zrozumiały dla człowieka opis tego, jak miejsce docelowe jest powiązane z punktem orientacyjnym. Na przykład: „W pobliżu Empire State Building” lub „Naprzeciwko Białego Domu”.
tags[]

Landmark.Tag

Tagi opisujące, jak można wykorzystać punkt orientacyjny w kontekście miejsca docelowego.
straight_line_distance_meters

double

Tylko dane wyjściowe. Odległość w linii prostej od tego punktu orientacyjnego do miejsca docelowego w metrach.
travel_distance_meters

double

Tylko dane wyjściowe. Odległość od tego punktu orientacyjnego do miejsca docelowego w metrach, mierzona wzdłuż sieci dróg.
Pole zbiorcze landmark. Punkt orientacyjny. landmark może mieć tylko jedną z tych wartości:
place

PlaceView

Miejsce reprezentujące ten punkt orientacyjny.

Tag

Lista wszystkich możliwych tagów, które opisują, jak można wykorzystać punkt orientacyjny w kontekście miejsca docelowego.

Jeśli adres zawiera zarówno tag ADDRESS, jak i ARRIVAL, oznacza to, że punkt orientacyjny jest dobrze znany w okolicy i znajduje się blisko miejsca docelowego.

Wartości w polu enum
TAG_UNSPECIFIED Nie używane.
ADDRESS lokalnie znane miejsce, które może służyć do określania ogólnej lokalizacji miejsca docelowego. Zwykle w odległości kilkuset metrów od miejsca docelowego. Są one podobne do punktów orientacyjnych zwracanych przez funkcję deskryptorów adresu interfejsu Geocoding API: https://developers.google.com/maps/documentation/geocoding/address-descriptors/requests-address-descriptors.
ARRIVAL Miejsce, które może pomóc w dotarciu do celu. Przydatne podczas nawigacji, gdy jesteś blisko celu. Może to być np. miejsce po drugiej stronie ulicy niż miejsce docelowe. Punkt orientacyjny z tym tagiem jest zwykle bliżej miejsca docelowego niż punkty orientacyjne z tagiem ADDRESS.

Punkt nawigacyjny to miejsce obok drogi, w którym może zakończyć się nawigacja.

Pola
navigation_point_token

string

Tylko dane wyjściowe. Token, którego można użyć do identyfikacji tego punktu nawigacyjnego.
display_name

LocalizedText

Wyświetlana nazwa tego punktu nawigacyjnego. Na przykład „5th Ave” lub „Gate B”.
location

LatLng

Punkt obok fragmentu drogi, w którym powinna się zakończyć nawigacja. Punkt jest celowo lekko przesunięty od osi drogi, aby wyraźnie oznaczyć stronę drogi, po której znajduje się miejsce.
travel_modes[]

NavigationPoint.TravelMode

Tryby podróży odpowiednie dla tego punktu nawigacyjnego.
usages[]

NavigationPoint.Usage

Zastosowania obsługiwane przez ten punkt nawigacyjny.

TravelMode

Tryby podróży odpowiednie dla tego punktu nawigacyjnego.

Wartości w polu enum
TRAVEL_MODE_UNSPECIFIED Nie używane.
DRIVE Nadaje się do jazdy.
WALK Odpowiednie na spacery.

Wykorzystanie

Zastosowania obsługiwane przez ten punkt nawigacyjny.

Wartości w polu enum
USAGE_UNSPECIFIED Nie używane.
UNKNOWN Nieznany typ użycia. Większość punktów nawigacyjnych będzie oznaczona symbolem UNKNOWN, co nie musi oznaczać, że ich użycie jest w jakikolwiek sposób ograniczone. Ta nawigacja może być nadal odpowiednia w przypadku odbioru lub dostawy.
DROPOFF Odpowiednie do wysadzenia pasażera. Na przykład miejsce docelowe przejazdu.
PICKUP Odpowiednie do odbioru pasażera. Na przykład miejsce odbioru pasażerów.

PlaceView

Reprezentuje widok miejsca w interfejsie Places API. Zawiera też dodatkowe informacje dotyczące miejsc docelowych, takie jak typ struktury i wielokąt wyświetlania.

W niektórych przypadkach PlaceView o tym samym identyfikatorze miejsca może różnić się od tego, co jest zwracane przez interfejs Places API w polach types i display_name.

Pola
place

string

Nazwa zasobu tego miejsca w formacie places/{placeId}.
display_name

LocalizedText

Zrozumiały dla człowieka opis miejsca. np. „Brama B”, „McDonalds”.
primary_type

string

Główny typ miejsca. Listę możliwych wartości znajdziesz na stronie https://developers.google.com/maps/documentation/places/web-service/place-types.

Uwaga: to pole nie zawsze jest wypełnione. W takich sytuacjach przygotuj się na użycie pola types.
types[]

string

Wszystkie powiązane typy miejsc. Listę możliwych wartości znajdziesz na stronie https://developers.google.com/maps/documentation/places/web-service/place-types.
formatted_address

string

Adres w jednym wierszu.
postal_address

PostalAddress

Ustrukturyzowany adres.
structure_type

PlaceView.StructureType

Rodzaj obiektu odpowiadający temu miejscu.
location

LatLng

Lokalizacja tego miejsca. W przypadku miejsc z wielokątami wyświetlania może to być dobre miejsce na umieszczenie znacznika na mapie.
display_polygon

Struct

Obrys wielokąta miejsca w formacie GeoJSON, zgodnie z formatem RFC 7946: https://datatracker.ietf.org/doc/html/rfc7946#section-3.1.6.

Uwaga: format RFC 7946 obsługuje wielokąty, więc jeden display_polygon obiekt może reprezentować wiele wielokątów.

StructureType

Typ struktury, którą reprezentuje to miejsce.

Wartości w polu enum
STRUCTURE_TYPE_UNSPECIFIED Nie używane.
POINT Lokalizacja punktowa.
SECTION Podsekcja budynku.
BUILDING budynek,
GROUNDS Duży obszar, na którym zwykle znajduje się wiele budynków, np. kampus uniwersytecki, kompleks apartamentów lub centrum handlowe.

PlusCode

Plus Code (http://plus.codes) to odniesienie do lokalizacji w 2 formatach: kod globalny określający prostokąt o wymiarach 14 m × 14 m (1/8000 stopnia) lub mniejszy oraz kod złożony, który zastępuje prefiks lokalizacją odniesienia.

Pola
global_code

string

Globalny (pełny) kod miejsca, np. „9FWM33GV+HQ”, reprezentujący obszar o wymiarach 1/8000 stopnia na 1/8000 stopnia (~14 × 14 metrów).
compound_code

string

Kod złożony miejsca, np. „33GV+HQ, Ramberg, Norwegia”, zawierający sufiks kodu globalnego i zastępujący prefiks sformatowaną nazwą elementu odniesienia.

SearchDestinationsRequest

Komunikat żądania dla DestinationService.SearchDestinations.

Pola
travel_modes[]

NavigationPoint.TravelMode

Opcjonalnie. Tryby podróży, dla których mają być filtrowane punkty nawigacyjne. Ma to wpływ na pole navigation_points zwracane w odpowiedzi. Jeśli to pole jest puste, można zwrócić punkty nawigacyjne wszystkich środków transportu.
language_code

string

Opcjonalnie. Język, w którym mają być zwracane wyniki.
region_code

string

Opcjonalnie. Kod regionu. Kod regionu określony jako 2-znakowa wartość ccTLD („domena najwyższego poziomu”). Ten parametr wpływa na wyniki na podstawie obowiązujących przepisów. Ten parametr ma też wpływ na wyniki usługi, ale nie ogranicza ich w pełni.

Pole zbiorcze primary_query. Wyszukaj główne miejsce docelowe. Może to być miejsce, pełny adres lub lokalizacja LatLng. Niektóre miejsca i adresy z minimalną ilością informacji nie będą mogły zostać przekształcone w miejsce docelowe.

Miejsca docelowe są tworzone na podstawie określonego zapytania głównego.

Uwaga: obsługiwane są tylko miejsca i adresy, które mogą być miejscem docelowym nawigacji. Na przykład miejsce, które reprezentuje dom lub kompleks apartamentów, może być użyte jako główne zapytanie, ale miejsca, które reprezentują miejscowość lub obszar administracyjny, nie mogą być użyte jako główne zapytanie. Pole primary_query może mieć tylko jedną z tych wartości:
place

string

Nazwa zasobu miejsca w formacie places/{place_id}.
address_query

SearchDestinationsRequest.AddressQuery

Ulica i numer.
location_query

SearchDestinationsRequest.LocationQuery

dokładną lokalizację,

AddressQuery

Ulica i numer, które chcesz wyszukać. Adresy należy podawać w formacie używanym przez krajową pocztę w danym kraju.

Pola
Pole zbiorcze kind. Zapytanie o adres. kind może mieć tylko jedną z tych wartości:
address

PostalAddress

Adres w formacie adresu pocztowego.
address_query

string

Adres sformatowany w jednym wierszu.

LocationQuery

zapytanie o lokalizację, które pozwala określić pobliskie miejsce docelowe;

Uwaga: jeśli zapytanie o lokalizację dotyczy budynku, w którym znajdują się lokale, zwrócone miejsce główne może być lokalem. W takich przypadkach pole containing_places będzie zawierać budynek.

Pola
place_filter

SearchDestinationsRequest.LocationQuery.PlaceFilter

Opcjonalnie. Filtry, które mają być stosowane do kandydatów na miejsca docelowe.
Pole zbiorcze kind. Zapytanie o lokalizację. kind może mieć tylko jedną z tych wartości:
location

LatLng

Dokładna lokalizacja LatLng.

PlaceFilter

Filtry, które mają być stosowane do kandydatów na miejsca docelowe.

Pola
structure_type

PlaceView.StructureType

Opcjonalnie. Jeśli ta opcja jest włączona, wszystkie miejsca docelowe mają gwarancję, że będą zawierać miejsce główne o tym typie struktury. Może to spowodować odfiltrowanie niektórych miejsc docelowych lub ich uogólnienie/doprecyzowanie.

Jeśli na przykład podasz wartość GROUNDS, wszystkie zwrócone miejsca docelowe będą miały miejsce główne o typie struktury GROUNDS. Może to spowodować odfiltrowanie niektórych miejsc docelowych, które nie są częścią terenu, lub ograniczenie zwracanych miejsc docelowych do poziomu terenu.

Innym zastosowaniem tego pola jest łatwiejsze wyodrębnianie wielokątów wyświetlania budynków. Jeśli na przykład podasz wartość BUILDING, wielokąt wyświetlania miejsca głównego będzie dotyczyć budynku w określonej lokalizacji.
addressability

SearchDestinationsRequest.LocationQuery.PlaceFilter.Addressability

Opcjonalnie. Jeśli zostanie określony, zwraca tylko miejsca docelowe, które spełniają odpowiednie kryteria adresowalności.

Adresowalność

Określa opcje filtrowania pod kątem możliwości kierowania. W przyszłości możemy dodać nowe wartości.

Wartości w polu enum
ADDRESSABILITY_UNSPECIFIED Jeśli nie zostanie określona, usługa wybierze odpowiednią wartość domyślną.
ANY Możliwość kierowania reklam nie jest kryterium filtrowania. Miejsca docelowe są zwracane niezależnie od tego, czy można do nich kierować reklamy.
PRIMARY Wszystkie zwrócone miejsca docelowe będą miały główne miejsce z adresem lub nazwą na poziomie ulicy.
WEAK Wszystkie zwrócone miejsca docelowe będą miały miejsce główne lub miejsce podrzędne z adresem lub nazwą na poziomie ulicy.

SearchDestinationsResponse

Wiadomość z odpowiedzią dla DestinationService.SearchDestinations.

Pola
destinations[]

Destination

Lista miejsc docelowych.

Jeśli na podstawie głównego zapytania można jednoznacznie określić główne miejsce docelowe, usługa zwraca 1 wynik. W przeciwnym razie usługa może zwrócić wiele wyników w celu ujednoznacznienia lub nie zwrócić żadnego wyniku.