Przenieś do wyszukiwania w pobliżu (nowość)

Places API obsługuje wyszukiwanie w pobliżu (starsza wersja). Jeśli znasz funkcję wyszukiwania w pobliżu (starsza wersja), w wyszukiwaniu w pobliżu (nowa wersja) wprowadzono te zmiany:

  • Nowa funkcja wyszukiwania w pobliżu korzysta z żądań HTTP POST. Przekazywanie parametrów w treści żądania lub w nagłówkach jako część żądania HTTP POST. W przypadku wyszukiwania w pobliżu (wersja starsza) parametry adresu URL są przekazywane za pomocą żądania HTTP GET.
  • Maskowanie pól jest wymagane. Musisz określić, które pola mają być zwracane w odpowiedzi. Nie ma domyślnej listy zwracanych pól. Jeśli pominiesz tę listę, metody zwrócą błąd. Więcej informacji znajdziesz w artykule FieldMask.
  • Wyszukiwanie w pobliżu (nowa wersja) obsługuje jako mechanizm uwierzytelniania zarówno klucze API, jak i tokeny OAuth.
  • W przypadku wyszukiwania w pobliżu (nowa wersja) obsługiwany jest tylko format odpowiedzi JSON.
  • Wszystkie żądania, które zawierają zapytanie tekstowe, powinny teraz używać wyszukiwania tekstowego (nowego), ponieważ wyszukiwanie w pobliżu (nowe) nie obsługuje wprowadzania tekstu.
  • Format odpowiedzi JSON w przypadku wyszukiwania w pobliżu (nowy) został zmieniony w porównaniu do starszych interfejsów API. Więcej informacji znajdziesz w artykule Migracja odpowiedzi interfejsu Places API.

Tabela poniżej zawiera parametry z sekcji „Wyszukiwarka lokalna (starsza wersja)”, które zostały zmienione lub zmodyfikowane w sekcji „Wyszukiwarka lokalna (nowa wersja)”, a także parametry, które nie są już obsługiwane.

Parametr prądu Nowy parametr Uwagi
keyword Nieobsługiwane. Zamiast tego użyj kolumny Wyszukiwanie tekstowe (nowa).
language languageCode
location locationRestriction Wymagany.
maxprice/minprice Nieobsługiwane.
maxResultCount Nowy parametr.
opennow Nieobsługiwane.
pagetoken Nieobsługiwane.
radius Skorzystaj z funkcji locationRestriction.
rankby rankPreference
regionCode Nowy parametr.
type includedTypes
excludedTypes
includedPrimaryTypes
excludedPrimaryTypes
Nowe parametry mogą też przyjmować różne wartości typu. Starsze wersje interfejsu API obsługują tylko jedną wartość.

Przykładowe żądanie

Ten przykładowy żądanie GET używa wyszukiwania w pobliżu (starsza wersja). W tym przykładzie żądasz odpowiedzi w formacie JSON zawierającej informacje o miejscach typu restaurant i przekazujesz wszystkie parametry jako parametry adresu URL:

curl -L -X GET \
'https://maps.googleapis.com/maps/api/place/nearbysearch/json?location=37.7937%2C-122.3965&radius=500&type=restaurant&key=API_KEY'

W przypadku wyszukiwania w pobliżu (nowej wersji) wysyłasz żądanie POST i przekazujesz wszystkie parametry w treści żądania JSON lub w nagłówkach jako część żądania POST. W tym przykładzie użyto też maski pola, więc odpowiedź zawiera tylko nazwę wyświetlaną i sformatowany adres miejsca:

curl -X POST -d '{
  "includedTypes": ["restaurant"],
  "locationRestriction": {
    "circle": {
      "center": {
        "latitude": 37.7937,
        "longitude": -122.3965},
      "radius": 500.0
    }
  }
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.displayName,places.formattedAddress" \
https://places.googleapis.com/v1/places:searchNearby