Переход на текстовый поиск (новинка)

Разработчики из Европейской экономической зоны (ЕЭЗ)

Введение

Places API (Legacy) supports Text Search (Legacy) . If you are familiar with Text Search (Legacy), Text Search (New) makes the following changes:

  • Text Search (New) uses HTTP POST requests. Pass parameters in the request body or in headers as part of an HTTP POST request. In contrast, with Text Search (Legacy), you pass URL parameters using an HTTP GET request.
  • Field masking is required. You must specify which fields you want returned in the response. There is no default list of returned fields. If you omit this list, the methods return an error. For more information, see FieldMask .
  • Функция текстового поиска (новая) поддерживает как ключи API , так и токены OAuth в качестве механизма аутентификации.
  • В текстовом поиске (новая функция) в качестве формата ответа поддерживается только JSON.

  • В функции текстового поиска (устаревшая версия) можно указывать координаты широты и долготы в строке запроса. Например: query=37.4239,-122.0925 . Эта опция не поддерживается в функции текстового поиска (новая версия).

    Используйте функцию обратного геокодирования для поиска по координатам и получения адреса, или функцию поиска поблизости (новая функция) для поиска мест вокруг определенного местоположения.

  • Формат JSON-ответа для текстового поиска (новый) изменился по сравнению с форматом устаревших API. Для получения более подробной информации см. раздел «Перенос ответа API Places» .

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

Текущий параметр Новый параметр Примечания
evOptions Новый параметр.
language languageCode
location locationBias
maxprice/minprice priceLevels
opennow openNow
pagetoken pageToken
query textQuery Required in all requests.
radius locationBias Укажите радиус при определении параметра locationBias .
region regionCode
type includedType Only takes a single value.
strictTypeFiltering Новый параметр.

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

The following example GET request uses Text Search (Legacy). In this example, you request a JSON response containing information about "Spicy Vegetarian Food in Sydney, Australia" and pass all parameters as URL parameters:

curl -L -X GET \
'https://maps.googleapis.com/maps/api/place/textsearch/json?query=Spicy%20Vegetarian%20Food%20in%20Sydney%20Australia&key=API_KEY

With Text Search (New), you make a POST request and pass all parameters in the JSON request body or in headers as part of the POST request. This example also uses a field mask so the response only includes the display name and formatted address of the place:

curl -X POST -d '{
  "textQuery" : "Spicy Vegetarian Food in Sydney, Australia"
}' \
-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:searchText'