Package google.maps.geocode.v4alpha

Indeks

DestinationService

Usługa do pobierania miejsc docelowych.

Miejsce docelowe dostarcza kontekst hierarchiczny dotyczący miejsca, co pozwala na przykład znaleźć budynki mieszkalne w większym kompleksie mieszkalnym i na odwrót. Zapewnia też punkty nawigacyjne odpowiednie do przypadków użycia, takich jak wspólne przejazdy czy dostawa.

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
  • https://www.googleapis.com/auth/maps-platform.destinations

GeocodeService

Usługa do geokodowania.

GeocodeAddress

rpc GeocodeAddress(GeocodeAddressRequest) returns (GeocodeAddressResponse)

Ta metoda wykonuje geokodowanie adresu, które mapuje adres na 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 współrzędne 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 miejsce główne, miejsca powiązane, wejścia i punkty nawigacyjne.

Pola
primary

PlaceView

Główne miejsce określone przez primary_query w żądaniu.
containing_places[]

PlaceView

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

PlaceView

Bardziej precyzyjne miejsca podrzędne miejsca głównego. Na przykład jednostki znajdujące się w budynku.

Uwaga: w porównaniu z obiektem 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 mogą pomóc w określeniu lokalizacji miejsca docelowego lub dotarciu do niego.
entrances[]

Entrance

Wejścia do tego miejsca docelowego.
navigation_points[]

NavigationPoint

Punkty nawigacyjne dla tego miejsca docelowego.
parking_options

Destination.ParkingOptions

Opcje parkowania w tym miejscu docelowym.
arrival_summary

Destination.ArrivalSummary

Wygenerowane przez AI podsumowanie informacji o przybyciu do miejsca docelowego.

ArrivalSummary

Wygenerowane przez AI podsumowanie informacji o przybyciu do miejsca docelowego.

Pola
text

LocalizedText

Podsumowanie informacji o przybyciu do miejsca docelowego.
flag_content_url

string

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

LocalizedText

Tylko dane wyjściowe. Zawiera tekst powiadomienia dotyczącego podsumowania przyjazdu.

ParkingOptions

Informacje o opcjach parkowania w miejscu docelowym.

Pola
availability

Destination.ParkingOptions.Availability

Dostępność parkingu w tym miejscu docelowym.
parking_facilities[]

Destination.ParkingOptions.ParkingFacility

Parkingi w tym miejscu docelowym.
onsite_parking

bool

Na miejscu jest parking.
free_parking_lot

bool

Bezpłatne miejsca parkingowe.
paid_parking_lot

bool

Dostępne są płatne parkingi.
free_street_parking

bool

Dostępny jest bezpłatny parking przy ulicy.
paid_street_parking

bool

Dostępny jest płatny parking przy ulicy.
valet_parking

bool

Dostępny jest parking z obsługą.
free_garage_parking

bool

Bezpłatny parking w garażu.
paid_garage_parking

bool

Dostępny jest płatny parking zadaszony.

Dostępność

Zbiorcza miara trudności znalezienia miejsca parkingowego podczas wizyty w tym miejscu.

W przyszłości mogą zostać dodane nowe wartości.

Wartości w polu enum
AVAILABILITY_UNSPECIFIED Brak informacji o dostępności parkingu.
PLENTY Dostępnych jest wiele miejsc parkingowych.
SOMEWHAT_DIFFICULT Raczej trudno znaleźć miejsce parkingowe.
DIFFICULT Bardzo trudno znaleźć miejsce parkingowe.

ParkingFacility

Osobna, konkretna opcja parkowania (np. konkretny parking lub garaż) powiązana z miejscem docelowym. Zawiera szczegółowe informacje o konkretnym parkingu, podczas gdy nadrzędny komunikat ParkingOptions zawiera podsumowanie wszystkich dostępnych parkingów.

Pola
place

PlaceView

Reprezentacja miejsca tego konkretnego parkingu.
onsite

bool

Określa, czy ten parking znajduje się na terenie głównego miejsca docelowego. Jeśli to pole nie jest skonfigurowane, stan na miejscu jest nieznany.
popular

bool

Określa, czy ten parking jest popularnym wyborem wśród osób podróżujących do głównego miejsca docelowego. Jeśli to pole nie jest skonfigurowane, stan popularności jest nieznany.
straight_line_distance_meters

double

Odległość w linii prostej w metrach od głównego miejsca docelowego do tego parkingu.

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 z miejsca.

Pola
display_name

LocalizedText

Nazwa zrozumiała dla człowieka, np. „Bramka B”, „Wejście południowe”, „Wejście od 5 Alei”.
location

LatLng

Lokalizacja wejścia.
tags[]

Entrance.Tag

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

string

Budynek, w którym znajduje się wejście, w formacie places/{place_id}.
street_view_thumbnail

StreetViewThumbnail

Miniatura Street View przedstawiająca wejście. Obraz można pobrać z interfejsu Street View Static API. Więcej informacji znajdziesz na stronie https://developers.google.com/maps/documentation/streetview/request-streetview.
street_view_annotation

ImageAnnotation

Adnotacja dotycząca wejścia na street_view_thumbnail zwrócona powyżej.

Tag

Cechy opisujące wejście.

Wartości w polu enum
TAG_UNSPECIFIED Nieużywane.
PREFERRED

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

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

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

Uwaga: wejście PREFERRED może nie zapewniać dostępu do głównego miejsca, a wejście, które nie jest 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 zostać przeprowadzone wyszukiwanie. Ta lokalizacja służy jako preferencja, co oznacza, że wyniki w pobliżu podanej lokalizacji są preferowane.
language_code

string

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

string

Opcjonalnie: Kod regionu. Kod regionu określony jako dwuznakowa wartość ccTLD („domena najwyższego poziomu”). Parametr wpływa na wyniki zgodnie z obowiązującymi przepisami. Ten parametr będzie też wpływać na wyniki z usługi, ale nie będzie ich całkowicie 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 zostać przeprowadzone wyszukiwanie. Ta lokalizacja służy jako preferencja, co oznacza, że wyniki w pobliżu podanej lokalizacji są preferowane.

Pola
Pole zbiorcze type. Typy preferencji lokalizacji. type może mieć tylko jedną z tych wartości:
rectangle

Viewport

Prostokątne pole określone przez północno-wschodni i południowo-zachodni róg. rectangle.high() musi być północno-wschodnim punktem prostokątnego wizjera. Właściwość 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 utworzenie pustego zakresu szerokości geograficznej. Prostokątny widok nie może być szerszy niż 180 stopni.

GeocodeAddressResponse

Wiadomość z odpowiedzią dla: GeocodeService.GeocodeAddress.

Pola
results[]

GeocodeResult

Wynik geokodowania.

GeocodeLocationRequest

Komunikat żądania dla 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 dwuznakowa wartość ccTLD („domena najwyższego poziomu”). Parametr wpływa na wyniki zgodnie z obowiązującymi przepisami.
types[]

string

Opcjonalnie: Zestaw tagów typu, które ograniczają wyniki. Wyniki, które nie mają żadnego z określonych typów, są usuwane.

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 typ wyliczeniowy szczegółowości lokalizacji.
Pole zbiorcze location_input. Lokalizacja, która ma zostać poddana geokodowaniu. location_input może mieć tylko jedną z tych wartości:
location_query

string

Lokalizacja w formacie ciągu znaków „szer,dł”. Na przykład „64.7611872,-18.4705364”.
location

LatLng

Lokalizacja w uporządkowanym formacie.

GeocodeLocationResponse

Wiadomość z odpowiedzią dla: GeocodeService.GeocodeLocation.

Pola
results[]

GeocodeResult

Wynik geokodowania.
plus_code

PlusCode

Plus Code lokalizacji w żądaniu.

GeocodePlaceRequest

Komunikat żądania dla 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 dwuznakowa wartość ccTLD („domena najwyższego poziomu”). Parametr wpływa na wyniki zgodnie z obowiązującymi przepisami.

GeocodeResult

Wynik geokodowania zawiera informacje geograficzne o miejscu.

Pola
place

string

Nazwa zasobu tego miejsca w formacie places/{placeId}. Może służyć do wyszukiwania miejsca.
place_id

string

Unikalny identyfikator miejsca.
location

LatLng

Współrzędne geograficzne tego adresu.
granularity

GeocodeResult.Granularity

Stopień szczegółowości lokalizacji.
viewport

Viewport

Widoczny obszar odpowiedni do wyświetlania wyniku geokodowania.
bounds

Viewport

Ramka ograniczająca adres.
formatted_address

string

Adres sformatowany w jednym wierszu.
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 objętych kodem 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

Plus code lokalizacji w tym kodzie geograficznym.

AddressComponent

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

Pola
long_text

string

Pełny opis tekstowy 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 kraju Australia może mieć krótką nazwę „AU”.
types[]

string

Tablica wskazująca typy komponentu adresu.

Te wartości pochodzą z tabeli typów adresów i typów komponentów adresowych używanej przez Places API: https://developers.google.com/maps/documentation/places/web-service/place-types#address-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 Niezinterpolowana lokalizacja rzeczywistej działki odpowiadającej dopasowanemu adresowi.
RANGE_INTERPOLATED Interpolowany z zakresu numerów ulic. Jeśli na przykład wiemy, że odcinek ulicy Amphitheatre Pkwy zawiera numery 1600–1699, numer 1650 może zostać umieszczony w połowie drogi między punktami końcowymi.
GEOMETRIC_CENTER Środek geometryczny obiektu, dla którego mamy dane wielokątne.
APPROXIMATE Wszystkie pozostałe.

ImageAnnotation

Adnotacja na miniaturze obrazu, np. wielokąt obrysowujący wejście.

Pola
coordinates[]

ImageAnnotation.Coordinate

Lista współrzędnych, które tworzą wielokąt na obrazie. Współrzędne są uporządkowane w kierunku przeciwnym do ruchu wskazówek zegara.

Współrzędne

Współrzędna piksela punktu na obrazie. Punkt początkowy (0,0) to lewy górny róg lewego górnego piksela obrazu, przy czym oś X jest skierowana w prawo, a oś Y – w dół.

Pola
x_px

float

Współrzędna X.
y_px

float

Współrzędna Y.

Punkt orientacyjny

Punkty orientacyjne służą do wskazywania miejsca docelowego lub ułatwiania dotarcia do niego.

Pola
relational_description

LocalizedText

Zrozumiały dla człowieka opis relacji między miejscem docelowym a punktem orientacyjnym. Na przykład: „W pobliżu Pałacu Kultury i Nauki” lub „Naprzeciwko Sejmu”.
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ść pieszo od tego punktu orientacyjnego do miejsca docelowego w metrach.
Pole zbiorcze landmark. Punkt orientacyjny. landmark może mieć tylko jedną z tych wartości:
place

PlaceView

Miejsce, które reprezentuje ten punkt orientacyjny.

Tag

Lista wszystkich możliwych tagów opisujących, 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 zarówno ważny lokalnie, jak i znajduje się blisko miejsca docelowego.

Wartości w polu enum
TAG_UNSPECIFIED Nieużywane.
ADDRESS Znane miejsce w okolicy, które może służyć do określenia 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 adresów w interfejsie 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 do nawigacji, gdy jesteś blisko celu. Może to być na przykład miejsce po drugiej stronie ulicy od miejsca docelowego. Punkt orientacyjny z tym tagiem jest zwykle bliżej miejsca docelowego niż punkty orientacyjne z tagiem ADDRESS.

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

Pola
navigation_point_token

string

Tylko dane wyjściowe. Token, którego można użyć do zidentyfikowania 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 kończyć się nawigacja. Punkt jest celowo lekko przesunięty względem osi drogi, aby wyraźnie oznaczyć stronę drogi, po której znajduje się miejsce.
travel_modes[]

NavigationPoint.TravelMode

Tryby podróży, które są odpowiednie dla tego punktu nawigacyjnego.
usages[]

NavigationPoint.Usage

Wyświetla listę usages obsługiwanych przez ten punkt nawigacyjny. Jeśli jest puste, nie musi to oznaczać, że jego użycie jest w jakikolwiek sposób ograniczone. Wszystkie punkty nawigacyjne mogą być używane do ogólnej nawigacji.
street_view_thumbnail

StreetViewThumbnail

Miniatura Street View przedstawiająca punkt nawigacyjny, jeśli jest dostępna. Obraz można pobrać z interfejsu Street View Static API. Więcej informacji znajdziesz na stronie https://developers.google.com/maps/documentation/streetview/request-streetview.
entrance_annotation

ImageAnnotation

Adnotacja wejścia powiązanego z tym punktem nawigacyjnym na street_view_thumbnail zwróconym powyżej (jeśli jest dostępna).
altitude_meters

float

Wysokość punktu nawigacyjnego w metrach względem elipsoidy WGS-84.

TravelMode

Tryby podróży, które są odpowiednie dla tego punktu nawigacyjnego.

Wartości w polu enum
TRAVEL_MODE_UNSPECIFIED Nieużywane.
DRIVE Odpowiednie do jazdy.
WALK Odpowiednie do spacerów.

Wykorzystanie

Zastosowania obsługiwane przez ten punkt nawigacyjny. W przyszłości mogą zostać dodane nowe wartości.

Wartości w polu enum
USAGE_UNSPECIFIED Nieużywane.
UNKNOWN Wskazuje, że typ użycia jest nieznany.
DROPOFF Odpowiednie do wysadzania pasażerów. Na przykład miejsce wysiadania z samochodu.
PICKUP Odpowiednie do odebrania pasażera. Na przykład miejsce odbioru pasażera przez kierowcę.
PARKING Odpowiednie do parkowania. na przykład na parkingu.

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 się różnić od tego, co zwraca interfejs Places API w polach types i display_name.

Pola
place

string

Nazwa zasobu tego miejsca w formacie places/{placeId}. Może służyć do wyszukiwania miejsca.
place_id

string

Unikalny identyfikator miejsca.
display_name

LocalizedText

Zrozumiały dla człowieka opis miejsca. Na przykład „Bramka B”, „McDonalds”
primary_type

string

Główny typ tego 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 tego miejsca. 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

Uporządkowany adres.
structure_type

PlaceView.StructureType

Typ struktury odpowiadającej temu miejscu.
location

LatLng

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

Struct

Kontur wielokąta miejsca w formacie GeoJSON, przy użyciu formatu RFC 7946: https://datatracker.ietf.org/doc/html/rfc7946#section-3.1.6.

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

PlaceView.AddressComponent

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

AddressComponent

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

Pola
long_text

string

Pełny opis tekstowy 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 kraju Australia może mieć krótką nazwę „AU”.
types[]

string

Tablica wskazująca typy komponentu adresu.

Te wartości pochodzą z tabeli typów adresów i typów komponentów adresowych używanej przez Places API: https://developers.google.com/maps/documentation/places/web-service/place-types#address-types.
language_code

string

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

StructureType

Typ struktury, którą reprezentuje to miejsce.

Wartości w polu enum
STRUCTURE_TYPE_UNSPECIFIED Nieużywane.
POINT Lokalizacja punktu.
SECTION Podsekcja budynku.
BUILDING Budynek.
GROUNDS Duży obszar, który zwykle obejmuje kilka 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 definiujący prostokąt o wymiarach 14 m x 14 m (1/8000 stopnia) lub mniejszy oraz kod złożony, który zastępuje prefiks lokalizacją referencyjną.

Pola
global_code

string

Globalny (pełny) kod miejsca, np. „9FWM33GV+HQ”, reprezentujący obszar o wymiarach 1/8000 na 1/8000 stopnia (ok. 14 na 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 referencyjnego.

SearchDestinationsRequest

Komunikat żądania dla DestinationService.SearchDestinations.

Pola
travel_modes[]

NavigationPoint.TravelMode

Opcjonalnie: Środki transportu, 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, zwracane są punkty nawigacyjne dla 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 dwuznakowa wartość ccTLD („domena najwyższego poziomu”). Parametr wpływa na wyniki zgodnie z obowiązującymi przepisami. Ten parametr wpływa też na wyniki z usługi, ale nie ogranicza ich całkowicie.

Pole zbiorcze primary_query. Zapytanie dotyczące głównego miejsca docelowego. Może to być miejsce, pełny adres lub lokalizacja LatLng. Niektórych miejsc i adresów z minimalną ilością informacji nie można przekształcić w miejsce docelowe.

Miejsca docelowe są tworzone na podstawie określonego zapytania podstawowego.

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żywane jako zapytanie podstawowe, ale miejsca, które reprezentują miejscowość lub region, nie mogą być używane jako zapytanie podstawowe. 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

Adres, który chcesz wyszukać. Adresy należy podawać w formacie używanym przez krajową pocztę danego kraju.

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

PostalAddress

Adres pocztowy w formacie adresu pocztowego.
address_query

string

Adres sformatowany jako pojedynczy wiersz.

LocationQuery

zapytanie o lokalizację, aby zidentyfikować główne miejsce docelowe w pobliżu;

Uwaga: jeśli zapytanie o lokalizację dotyczy budynku, który zawiera podlokale, możliwe, że zwrócone miejsce główne będzie podlokalem. W takich przypadkach pole containing_places będzie zawierać budynek.

Pola
place_filter

SearchDestinationsRequest.LocationQuery.PlaceFilter

Opcjonalnie: Filtry, które mają zostać zastosowane do potencjalnych miejsc docelowych.
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ą zostać zastosowane do potencjalnych miejsc docelowych.

Pola
structure_type

PlaceView.StructureType

Opcjonalnie: Jeśli podasz tę wartość, wszystkie miejsca docelowe będą miały główne miejsce o tym typie struktury. Może to spowodować odfiltrowanie niektórych miejsc docelowych lub ich uogólnienie albo uściślenie.

Jeśli na przykład podasz GROUNDS, wszystkie zwrócone miejsca docelowe będą miały główne miejsce o typie struktury GROUNDS. Może to spowodować odfiltrowanie niektórych miejsc docelowych, które nie są częścią terenu, lub uogólnienie 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 BUILDING, wielokąt wyświetlania głównego miejsca będzie dotyczyć budynku w określonej lokalizacji.
addressability

SearchDestinationsRequest.LocationQuery.PlaceFilter.Addressability

Opcjonalnie: Jeśli zostanie określony, zwracane będą tylko miejsca docelowe, które spełniają odpowiednie kryteria adresowalności.

Możliwość identyfikacji

Definiuje opcje filtrowania adresowalności. W przyszłości mogą zostać dodane 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ść adresowania nie jest kryterium filtrowania. Miejsca docelowe są zwracane niezależnie od ich adresowalności.
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

Komunikat odpowiedzi dla DestinationService.SearchDestinations.

Pola
destinations[]

Destination

Lista miejsc docelowych.

Usługa zwraca 1 wynik, jeśli na podstawie zapytania podstawowego można jednoznacznie zidentyfikować miejsce docelowe. W przeciwnym razie usługa może zwrócić wiele wyników do uściślenia lub nie zwrócić żadnych wyników.

StreetViewThumbnail

Parametry reprezentujące miniaturę Google Street View. Te parametry mogą służyć do żądania obrazu Street View z interfejsu Street View Static API. Więcej informacji znajdziesz na stronie https://developers.google.com/maps/documentation/streetview/request-streetview.

Pola
pano

string

Identyfikator konkretnej panoramy.
width_px

int32

Szerokość wyjściowego obrazu miniatury w pikselach. Uwaga: gdy żądasz adnotacji obok miniatury, musisz użyć tych wartości wysokości i szerokości w żądaniu do interfejsu Street View API, aby współrzędne adnotacji były prawidłowo dopasowane do obrazu.
height_px

int32

Wysokość wyjściowego obrazu miniatury w pikselach. Uwaga: gdy żądasz adnotacji obok miniatury, musisz użyć tych wartości wysokości i szerokości w żądaniu do interfejsu Street View API, aby współrzędne adnotacji były prawidłowo dopasowane do obrazu.
heading_degree

float

Orientacja pozioma kamery w stopniach. Zakres [0, 360). 0 oznacza północ, a 90 – wschód.
pitch_degree

float

Orientacja pionowa kamery w stopniach. Zakres [-90, 90]. 0 to horyzont, +90 to prosto w górę, a -90 to prosto w dół.
fov_degree

float

Poziome pole widzenia w stopniach. Zakres (0, 180]. Określa poziom powiększenia. Mniejsze pole widzenia oznacza większe powiększenie.