Переход на поиск поблизости (новинка)

API Places поддерживает существующий поиск поблизости . Если вы знакомы с существующим поиском поблизости, новая версия поиска поблизости вносит следующие изменения:

  • Новый поиск поблизости использует запросы HTTP POST. Передавайте параметры в теле запроса или в заголовках как часть запроса HTTP POST. Напротив, в существующем поиске поблизости вы передаете параметры URL-адреса с помощью HTTP-запроса GET.
  • Требуется маскировка полей. Вы должны указать, какие поля вы хотите вернуть в ответе. Не существует списка возвращаемых полей по умолчанию. Если вы опустите этот список, методы вернут ошибку. Для получения дополнительной информации см. FieldMask .
  • Новый поиск поблизости поддерживает как ключи API , так и токены OAuth в качестве механизма аутентификации.
  • В качестве формата ответа в новом поиске поблизости поддерживается только JSON.
  • Все запросы, включающие текстовый запрос, теперь должны использовать текстовый поиск (новое), поскольку поиск поблизости (новое) не поддерживает ввод текста.
  • Формат ответа JSON для API поиска поблизости (новый) изменился по сравнению с форматом существующих API. Дополнительные сведения см. в разделе Миграция ответа Places API .

В следующей таблице перечислены параметры существующего поиска поблизости, которые были переименованы или изменены для нового поиска поблизости, а также параметры, которые больше не поддерживаются.

Текущий параметр Новый параметр Примечания
keyword Не поддерживается. Вместо этого используйте текстовый поиск (новое) .
language languageCode
location locationRestriction Необходимый.
maxprice/minprice Не поддерживается.
maxResultCount Новый параметр.
opennow Не поддерживается.
pagetoken Не поддерживается.
radius Используйте locationRestriction сейчас.
rankby rankPreference
regionCode Новый параметр.
type includedTypes
excludedTypes
includedPrimaryTypes
excludedPrimaryTypes
Новые параметры также принимают значения нескольких типов. Существующий API принимает только одно значение.

Пример запроса

В следующем примере запроса GET используется существующий поиск поблизости. В этом примере вы запрашиваете ответ JSON, содержащий информацию о местах типа restaurant и передаете все параметры как параметры 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'

С помощью поиска поблизости (новое) вы делаете запрос POST и передаете все параметры в теле запроса JSON или в заголовках как часть запроса POST. В этом примере также используется маска поля, поэтому ответ включает только отображаемое имя и форматированный адрес места:

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
,

API Places поддерживает существующий поиск поблизости . Если вы знакомы с существующим поиском поблизости, новая версия поиска поблизости вносит следующие изменения:

  • Новый поиск поблизости использует запросы HTTP POST. Передавайте параметры в теле запроса или в заголовках как часть запроса HTTP POST. Напротив, в существующем поиске поблизости вы передаете параметры URL-адреса с помощью HTTP-запроса GET.
  • Требуется маскировка полей. Вы должны указать, какие поля вы хотите вернуть в ответе. Не существует списка возвращаемых полей по умолчанию. Если вы опустите этот список, методы вернут ошибку. Для получения дополнительной информации см. FieldMask .
  • Новый поиск поблизости поддерживает как ключи API , так и токены OAuth в качестве механизма аутентификации.
  • В качестве формата ответа в новом поиске поблизости поддерживается только JSON.
  • Все запросы, включающие текстовый запрос, теперь должны использовать текстовый поиск (новое), поскольку поиск поблизости (новое) не поддерживает ввод текста.
  • Формат ответа JSON для API поиска поблизости (новый) изменился по сравнению с форматом существующих API. Дополнительные сведения см. в разделе Миграция ответа Places API .

В следующей таблице перечислены параметры существующего поиска поблизости, которые были переименованы или изменены для нового поиска поблизости, а также параметры, которые больше не поддерживаются.

Текущий параметр Новый параметр Примечания
keyword Не поддерживается. Вместо этого используйте текстовый поиск (новое) .
language languageCode
location locationRestriction Необходимый.
maxprice/minprice Не поддерживается.
maxResultCount Новый параметр.
opennow Не поддерживается.
pagetoken Не поддерживается.
radius Используйте locationRestriction сейчас.
rankby rankPreference
regionCode Новый параметр.
type includedTypes
excludedTypes
includedPrimaryTypes
excludedPrimaryTypes
Новые параметры также принимают значения нескольких типов. Существующий API принимает только одно значение.

Пример запроса

В следующем примере запроса GET используется существующий поиск поблизости. В этом примере вы запрашиваете ответ JSON, содержащий информацию о местах типа restaurant и передаете все параметры как параметры 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'

С помощью поиска поблизости (новое) вы делаете запрос POST и передаете все параметры в теле запроса JSON или в заголовках как часть запроса POST. В этом примере также используется маска поля, поэтому ответ включает только отображаемое имя и форматированный адрес места:

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