Method: places.searchNearby

wyszukiwać miejsc w pobliżu lokalizacji;

Żądanie HTTP

POST https://places.googleapis.com/v1/places:searchNearby

Adres URL używa składni transkodowania gRPC.

Treść żądania

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

Zapis JSON 
{
  "languageCode": string,
  "regionCode": string,
  "includedTypes": [
    string
  ],
  "excludedTypes": [
    string
  ],
  "includedPrimaryTypes": [
    string
  ],
  "excludedPrimaryTypes": [
    string
  ],
  "maxResultCount": integer,
  "locationRestriction": {
    object (LocationRestriction)
  },
  "rankPreference": enum (RankPreference),
  "routingParameters": {
    object (RoutingParameters)
  }
}
Pola
languageCode

string

Szczegóły miejsca będą wyświetlane w preferowanym języku (jeśli jest dostępny). Jeśli kod języka nie jest określony lub nie jest rozpoznawany, mogą zostać zwrócone szczegóły miejsca w dowolnym języku, przy czym preferowany jest język angielski, jeśli takie szczegóły istnieją.

Aktualna lista obsługiwanych języków: https://developers.google.com/maps/faq#languagesupport.
regionCode

string

Kod Unicode kraju lub regionu (CLDR) lokalizacji, z której pochodzi żądanie. Ten parametr służy do wyświetlania szczegółów miejsca, np. nazwy miejsca w danym regionie (jeśli jest dostępny). Parametr może wpływać na wyniki w zależności od obowiązujących przepisów.

Więcej informacji znajdziesz na stronie https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html.

Pamiętaj, że 3-cyfrowe kody regionów nie są obecnie obsługiwane.
includedTypes[]

string

Typ miejsca (np. „restaurant” lub „gas_station”) z https://developers.google.com/maps/documentation/places/web-service/place-types.

Możesz określić maksymalnie 50 typów z tabeli A.

Jeśli występują jakieś sprzeczne typy, np. typ występuje zarówno w includedTypes, jak i w excludedTypes, zwracany jest błąd INVALID_ARGUMENT.

Jeśli typ Miejsca jest określony z wieloma ograniczeniami typu, zwracane są tylko miejsca, które spełniają wszystkie ograniczenia. Jeśli na przykład mamy {includedTypes = ["restaurant"], excludedPrimaryTypes = ["restaurant"]}, zwracane miejsca oferują usługi związane z „restauracją”, ale nie działają głównie jako „restauracje”.
excludedTypes[]

string

Wykluczony typ miejsca (np. „restaurant” lub „gas_station”) z witryny https://developers.google.com/maps/documentation/places/web-service/place-types.

Możesz określić maksymalnie 50 typów z tabeli A.

Jeśli klient podaje zarówno typy do uwzględnienia (np. restauracja), jak i typy do wykluczenia (np. kawiarnia), odpowiedź powinna zawierać miejsca, które są restauracjami, ale nie są kawiarniami. Odpowiedź zawiera miejsca, które pasują co najmniej do jednego z typów zawartych i do żadnego z typów wykluczonych.

Jeśli występują jakieś sprzeczne typy, np. typ występuje zarówno w includedTypes, jak i w excludedTypes, zwracany jest błąd INVALID_ARGUMENT.

Jeśli typ Miejsca jest określony z wieloma ograniczeniami typu, zwracane są tylko miejsca, które spełniają wszystkie ograniczenia. Jeśli na przykład mamy {includedTypes = ["restaurant"], excludedPrimaryTypes = ["restaurant"]}, zwracane miejsca oferują usługi związane z „restauracją”, ale nie działają głównie jako „restauracje”.
includedPrimaryTypes[]

string

Uwzględniony podstawowy typ Miejsca (np. „restaurant” lub „gas_station”) z https://developers.google.com/maps/documentation/places/web-service/place-types. Miejsce może mieć tylko jeden podstawowy typ z powiązanej z nim tabeli obsługiwanych typów.

Możesz określić maksymalnie 50 typów z tabeli A.

Jeśli występują jakieś sprzeczne typy podstawowe, np. typ występuje zarówno w sekcji includedPrimaryTypes, jak i excludedPrimaryTypes, zwracany jest błąd INVALID_ARGUMENT.

Jeśli typ Miejsca jest określony z wieloma ograniczeniami typu, zwracane są tylko miejsca, które spełniają wszystkie ograniczenia. Jeśli na przykład mamy {includedTypes = ["restaurant"], excludedPrimaryTypes = ["restaurant"]}, zwracane miejsca oferują usługi związane z „restauracją”, ale nie działają głównie jako „restauracje”.
excludedPrimaryTypes[]

string

Wykluczony podstawowy typ Miejsca (np. „restaurant” lub „gas_station”) z https://developers.google.com/maps/documentation/places/web-service/place-types.

Możesz określić maksymalnie 50 typów z tabeli A.

Jeśli występują jakieś sprzeczne typy podstawowe, np. typ występuje zarówno w sekcji includedPrimaryTypes, jak i excludedPrimaryTypes, zwracany jest błąd INVALID_ARGUMENT.

Jeśli typ Miejsca jest określony z wieloma ograniczeniami typu, zwracane są tylko miejsca, które spełniają wszystkie ograniczenia. Jeśli na przykład mamy {includedTypes = ["restaurant"], excludedPrimaryTypes = ["restaurant"]}, zwracane miejsca oferują usługi związane z „restauracją”, ale nie działają głównie jako „restauracje”.
maxResultCount

integer

Maksymalna liczba wyników do zwrócenia. Musi zawierać się w zakresie od 1 do 20 (domyślnie) włącznie. Jeśli liczba nie jest ustawiona, jest używany górny limit. Jeśli liczba jest ujemna lub przekracza górny limit, zwracany jest błąd INVALID_ARGUMENT.
locationRestriction

object (LocationRestriction)

Wymagany. Region wyszukiwania.
rankPreference

enum (RankPreference)

sposób porządkowania wyników w odpowiedzi.
routingParameters

object (RoutingParameters)

Opcjonalnie: Parametry, które wpływają na kierowanie do wyników wyszukiwania.

Treść odpowiedzi

Protokół odpowiedzi dla wyszukiwania w pobliżu.

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

Zapis JSON 
{
  "places": [
    {
      object (Place)
    }
  ],
  "routingSummaries": [
    {
      object (RoutingSummary)
    }
  ]
}
Pola
places[]

object (Place)

Lista miejsc spełniających wymagania użytkownika, np. typy miejsc, liczba miejsc i szczegółowe ograniczenia dotyczące lokalizacji.
routingSummaries[]

object (RoutingSummary)

Lista podsumowań tras, w której każdy wpis jest powiązany z odpowiednim miejscem w tym samym indeksie w polu places. Jeśli podsumowanie trasy jest niedostępne dla jednego z miejsc, będzie zawierać pusty wpis. Ta lista powinna zawierać tyle pozycji, ile jest podanych w liście miejsc.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

LocationRestriction

Region wyszukiwania.

Zapis JSON 
{

  // Union field type can be only one of the following:
  "circle": {
    object (Circle)
  }
  // End of list of possible types for union field type.
}
Pola

Pole unii type.

type może być tylko jednym z tych elementów:
circle

object (Circle)

Okrąg zdefiniowany przez punkt środkowy i promień.

RankPreference

sposób porządkowania wyników w odpowiedzi.

Wartości w polu enum
RANK_PREFERENCE_UNSPECIFIED Wartość RankPreference nie została ustawiona. Domyślnie będzie używane miejsce według popularności.
DISTANCE Ustawia wyniki według odległości.
POPULARITY Ustawia wyniki według popularności.