Method: geocode.destinations.searchDestinations

Ta metoda wyszukuje miejsca docelowe i zwraca ich listę.

Żądanie HTTP

POST https://geocode.googleapis.com/v4alpha/geocode/destinations

Adres URL używa składni transkodowania gRPC.

Treść żądania

Treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "travelModes": [
    enum (NavigationPoint.TravelMode)
  ],
  "languageCode": string,
  "regionCode": string,

  // Union field primary_query can be only one of the following:
  "place": string,
  "addressQuery": {
    object (SearchDestinationsRequest.AddressQuery)
  },
  "locationQuery": {
    object (SearchDestinationsRequest.LocationQuery)
  }
  // End of list of possible types for union field primary_query.
}
Pola
travelModes[]

enum (NavigationPoint.TravelMode)

Opcjonalnie: Środki transportu, dla których mają być filtrowane punkty nawigacyjne. Ma to wpływ na pole navigationPoints zwracane w odpowiedzi. Jeśli to pole jest puste, zwracane są punkty nawigacyjne dla wszystkich środków transportu.
languageCode

string

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

string

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

Pole zbiorcze primary_query. Wykonywanie zapytań dotyczących 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ż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/{placeId}.
addressQuery

object (SearchDestinationsRequest.AddressQuery)

Ulica i numer.
locationQuery

object (SearchDestinationsRequest.LocationQuery)

dokładną lokalizację,

Treść odpowiedzi

Komunikat odpowiedzi dla DestinationService.SearchDestinations.

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "destinations": [
    {
      object (Destination)
    }
  ]
}
Pola
destinations[]

object (Destination)

Lista miejsc docelowych.

Usługa zwraca 1 wynik, jeśli na podstawie zapytania podstawowego można jednoznacznie określić główne 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.

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

SearchDestinationsRequest.AddressQuery

Adres ulicy, który chcesz wyszukać. Adresy należy podawać zgodnie z formatem używanym przez krajową pocztę w danym kraju.

Zapis JSON 
{

  // Union field kind can be only one of the following:
  "address": {
    object (PostalAddress)
  },
  "addressQuery": string
  // End of list of possible types for union field kind.
}
Pola
Pole zbiorcze kind. Zapytanie o adres. kind może mieć tylko jedną z tych wartości:
address

object (PostalAddress)

Adres w formacie adresu pocztowego.
addressQuery

string

Adres sformatowany jako pojedynczy wiersz.

SearchDestinationsRequest.LocationQuery

zapytanie o lokalizację, aby zidentyfikować pobliskie miejsce docelowe;

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 containingPlaces będzie zawierać budynek.

Zapis JSON 
{
  "placeFilter": {
    object (SearchDestinationsRequest.LocationQuery.PlaceFilter)
  },

  // Union field kind can be only one of the following:
  "location": {
    object (LatLng)
  }
  // End of list of possible types for union field kind.
}
Pola
placeFilter

object (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

object (LatLng)

Dokładna lokalizacja LatLng.

SearchDestinationsRequest.LocationQuery.PlaceFilter

Filtry, które mają zostać zastosowane do potencjalnych miejsc docelowych.

Zapis JSON 
{
  "structureType": enum (PlaceView.StructureType),
  "addressability": enum (SearchDestinationsRequest.LocationQuery.PlaceFilter.Addressability)
}
Pola
structureType

enum (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 uproszczenie 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

enum (SearchDestinationsRequest.LocationQuery.PlaceFilter.Addressability)

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

PlaceView.StructureType

Typ struktury, którą reprezentuje to miejsce.

Wartości w polu enum
STRUCTURE_TYPE_UNSPECIFIED Nie używane.
POINT Lokalizacja punktu.
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.

SearchDestinationsRequest.LocationQuery.PlaceFilter.Addressability

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.

Miejsce docelowe

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

Zapis JSON 
{
  "primary": {
    object (PlaceView)
  },
  "containingPlaces": [
    {
      object (PlaceView)
    }
  ],
  "subDestinations": [
    {
      object (PlaceView)
    }
  ],
  "landmarks": [
    {
      object (Landmark)
    }
  ],
  "entrances": [
    {
      object (Entrance)
    }
  ],
  "navigationPoints": [
    {
      object (NavigationPoint)
    }
  ],
  "parkingOptions": {
    object (Destination.ParkingOptions)
  },
  "arrivalSummary": {
    object (Destination.ArrivalSummary)
  }
}
Pola
primary

object (PlaceView)

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

object (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.
subDestinations[]

object (PlaceView)

Bardziej precyzyjne podrzędne miejsca docelowe w miejscu głównym. 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[]

object (Landmark)

Punkty orientacyjne, które mogą pomóc w określeniu lokalizacji miejsca docelowego lub dotarciu do niego.
entrances[]

object (Entrance)

Wejścia do tego miejsca docelowego.
navigationPoints[]

object (NavigationPoint)

Punkty nawigacyjne dla tego miejsca docelowego.
parkingOptions

object (Destination.ParkingOptions)

Opcje parkowania w tym miejscu docelowym.
arrivalSummary

object (Destination.ArrivalSummary)

Wygenerowane przez AI podsumowanie informacji o przybyciu do miejsca docelowego.

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 przypadku pól types i displayName.

Zapis JSON 
{
  "place": string,
  "displayName": {
    object (LocalizedText)
  },
  "primaryType": string,
  "types": [
    string
  ],
  "formattedAddress": string,
  "postalAddress": {
    object (PostalAddress)
  },
  "structureType": enum (PlaceView.StructureType),
  "location": {
    object (LatLng)
  },
  "displayPolygon": {
    object
  },
  "addressComponents": [
    {
      object (PlaceView.AddressComponent)
    }
  ]
}
Pola
place

string

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

string

Unikalny identyfikator miejsca.
displayName

object (LocalizedText)

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

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 miejsc tego miejsca. Listę możliwych wartości znajdziesz na stronie https://developers.google.com/maps/documentation/places/web-service/place-types.
formattedAddress

string

Adres w jednym wierszu.
postalAddress

object (PostalAddress)

Uporządkowany adres.
structureType

enum (PlaceView.StructureType)

Typ struktury odpowiadającej temu miejscu.
location

object (LatLng)

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

object (Struct format)

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 displayPolygon może reprezentować wiele wielokątów.
addressComponents[]

object (PlaceView.AddressComponent)

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

PlaceView.AddressComponent

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

Zapis JSON 
{
  "longText": string,
  "shortText": string,
  "types": [
    string
  ],
  "languageCode": string
}
Pola
longText

string

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

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.
languageCode

string

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

Punkt orientacyjny

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

Zapis JSON 
{
  "relationalDescription": {
    object (LocalizedText)
  },
  "tags": [
    enum (Landmark.Tag)
  ],
  "straightLineDistanceMeters": number,
  "travelDistanceMeters": number,

  // Union field landmark can be only one of the following:
  "place": {
    object (PlaceView)
  }
  // End of list of possible types for union field landmark.
}
Pola
relationalDescription

object (LocalizedText)

Zrozumiały dla człowieka opis tego, jak miejsce docelowe jest powiązane z punktem orientacyjnym. Na przykład: „W pobliżu Pałacu Kultury i Nauki” lub „Naprzeciwko Sejmu”.
tags[]

enum (Landmark.Tag)

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

number

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

number

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

object (PlaceView)

Miejsce, które reprezentuje ten punkt orientacyjny.

Landmark.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 podczas 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.

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.

Zapis JSON 
{
  "location": {
    object (LatLng)
  },
  "tags": [
    enum (Entrance.Tag)
  ],
  "place": string,
  "streetViewThumbnail": {
    object (StreetViewThumbnail)
  },
  "streetViewAnnotation": {
    object (ImageAnnotation)
  }
}
Pola
location

object (LatLng)

Lokalizacja wejścia.
tags[]

enum (Entrance.Tag)

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

string

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

object (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.
streetViewAnnotation

object (ImageAnnotation)

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

Entrance.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 np. głównym miejscem jest restauracja w pasażu handlowym, wejścia oznaczone jako „PREFEROWANE” będą prawdopodobnie prowadzić do samej restauracji, a pozostałe wejścia będą prowadzić do innych miejsc w budynku, np. do innych restauracji w pasażu handlowym.

Jeśli głównym miejscem jest 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. Jeśli jednak wejście zapewnia dostęp 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.

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.

Zapis JSON 
{
  "pano": string,
  "widthPx": integer,
  "heightPx": integer,
  "headingDegree": number,
  "pitchDegree": number,
  "fovDegree": number
}
Pola
pano

string

Identyfikator konkretnej panoramy.
widthPx

integer

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.
heightPx

integer

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.
headingDegree

number

Położenie poziome kamery w stopniach. Zakres [0, 360). 0 oznacza północ, a 90 – wschód.
pitchDegree

number

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

number

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

ImageAnnotation

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

Zapis JSON 
{
  "coordinates": [
    {
      object (ImageAnnotation.Coordinate)
    }
  ]
}
Pola
coordinates[]

object (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.

ImageAnnotation.Coordinate

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ół.

Zapis JSON 
{
  "xPx": number,
  "yPx": number
}
Pola
xPx

number

Współrzędna X.
yPx

number

Współrzędna Y.

Destination.ParkingOptions

Informacje o opcjach parkowania w miejscu docelowym.

Zapis JSON 
{
  "availability": enum (Destination.ParkingOptions.Availability),
  "onsiteParking": boolean,
  "freeParkingLot": boolean,
  "paidParkingLot": boolean,
  "freeStreetParking": boolean,
  "paidStreetParking": boolean,
  "valetParking": boolean,
  "freeGarageParking": boolean,
  "paidGarageParking": boolean
}
Pola
availability

enum (Destination.ParkingOptions.Availability)

Dostępność parkingu w tym miejscu docelowym.
onsiteParking

boolean

W miejscu docelowym znajduje się parking.
freeParkingLot

boolean

Oferuje bezpłatne parkingi.
paidParkingLot

boolean

Oferuje płatne parkingi.
freeStreetParking

boolean

Oferuje bezpłatny parking przy ulicy.
paidStreetParking

boolean

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

boolean

Oferuje parking z obsługą.
freeGarageParking

boolean

Oferuje bezpłatny parking w garażu.
paidGarageParking

boolean

Dostępny jest płatny parking zadaszony.

Destination.ParkingOptions.Availability

Zagregowany wskaźnik trudności w znalezieniu miejsca parkingowego podczas wizyty w tym miejscu.

W przyszłości możemy dodać 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.

Destination.ArrivalSummary

Podsumowanie wygenerowane przez AI dotyczące przybycia do miejsca docelowego.

Zapis JSON 
{
  "text": {
    object (LocalizedText)
  },
  "flagContentUrl": string,
  "disclosureText": {
    object (LocalizedText)
  }
}
Pola
text

object (LocalizedText)

Podsumowanie wrażeń po przybyciu do miejsca docelowego.
flagContentUrl

string

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

object (LocalizedText)

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