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

Deweloperzy z Europejskiego Obszaru Gospodarczego (EOG)

Wprowadzenie

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

  • Wyszukiwanie w pobliżu (nowość) używa żądań HTTP POST. Przekazuj parametry w treści żądania lub w nagłówkach w ramach żądania HTTP POST request. W przeciwieństwie do tego w wyszukiwaniu w pobliżu (wersja starsza) przekazujesz parametry adresu URL za pomocą żądania GET.
  • Wymagane jest maskowanie pól. 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 (nowość) obsługuje zarówno klucze interfejsu API jak i OAuth jako mechanizm uwierzytelniania.
  • W wyszukiwaniu w pobliżu (nowość) obsługiwany jest tylko format odpowiedzi JSON.
  • Wszystkie żądania zawierające zapytanie tekstowe powinny teraz korzystać z wyszukiwania tekstowego (nowość) ponieważ wyszukiwanie w pobliżu (nowość) nie obsługuje danych tekstowych.
  • Format odpowiedzi JSON w wyszukiwaniu w pobliżu (nowość) różni się od formatu starszych interfejsów API. Więcej informacji znajdziesz w artykule Migracja odpowiedzi Places API.

W tabeli poniżej znajdziesz parametry wyszukiwania w pobliżu (wersja starsza), które zostały zmienione lub zmodyfikowane w wyszukiwaniu w pobliżu (nowość), oraz parametry, które nie są już obsługiwane.

Aktualny parametr Nowy parametr Uwagi
keyword Nieobsługiwane. Zamiast tego użyj wyszukiwania tekstowego (nowość).
language languageCode
location locationRestriction Wymagane.
maxprice/minprice Nieobsługiwane.
maxResultCount Nowy parametr.
opennow Nieobsługiwane.
pagetoken Nieobsługiwane.
radius Teraz używaj parametru locationRestriction.
rankby rankPreference
regionCode Nowy parametr.
type includedTypes
excludedTypes
includedPrimaryTypes
excludedPrimaryTypes 		Nowe parametry akceptują też wiele wartości typu. Starszy interfejs API akceptuje tylko jedną wartość.

Przykładowe żądanie

Ten przykładowy kod żądania GET używa wyszukiwania w pobliżu (wersja starsza). W tym przykładzie prosisz o odpowiedź JSON zawierającą 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 (nowość) wysyłasz żądanie POST i przekazujesz wszystkie parametry w treści żądania JSON lub w nagłówkach w ramach żądania POST. Ten przykład używa też maski pola, dzięki czemu 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