Поиск мест поблизости с помощью Nearby Search

В этом документе вы узнаете, как использовать Nearby Search (New) API , чтобы создать простое и экономичное

местных заведений.

Функция "Обзор окрестностей" показывает пользователям основные объекты инфраструктуры возле указанного местоположения при поиске гостиницы или недвижимости. Обычно он состоит из интерактивной карты и дополнительной панели, которая содержит инструмент выбора мест и галерею фотографий. Вы узнаете о разных продуктах и возможностях платформы Google Карт, которые позволяют сделать приложение более интерактивным.

Примеры использования

Давайте разберемся, какие элементы интеграции с местными компаниями представляют ценность для пользователей.

• Поиск. Показывайте пользователям, что находится рядом с определенным местом, выводя на экран информацию о релевантных местах разных типов.

• Интерактивность. Пользователи могут выбрать место и динамически обновить данные.

  относительно этого места.

• Визуализация. Добавление отзывов и фотографий мест.

  и время ходьбы и расстояние, чтобы пользователи могли быстро понять, соответствует ли это их потребностям.

Эталонная архитектура

Местные кампании Discovery

Существует множество способов создать локальный поиск. Ниже приведен пример интеграции, в которой используются как хорошо известные API платформы Google Карт, так и некоторые новые функции. Если вы хотите использовать шаблонный подход к поиску местных компаний, используйте веб-компоненты.

Пример приложения

Пример пошагового руководства

В таблице ниже приведен пример приложения, разбитый на этапы, с описанием технической реализации с помощью API платформы Google Карт.

1. Поиск местоположения с автозаполнениемПоиск местоположения

• Загрузите Maps JavaScript API.
• Запрос автозаполнение мест или выбор местоположения на карте.

2. Показывайте местные достопримечательности с помощью Nearby Search (New) API.

• по популярности (более релевантные результаты) или по расстоянию.
• includedTypes, excludedTypes. Если вы представляете гостиницу, то можете исключить тип lodging и включить только подходящие типы, например restaurant, cafe, park, tourist_attraction.
• Используйте includedPrimaryTypes и excludedPrimaryTypes, чтобы лучше контролировать результаты.
• `locationRestriction, чтобы избежать недостаточного количества результатов или слишком удаленных мест. Если результатов нет, увеличьте размер круга или прямоугольника, прежде чем показывать результаты.

Пример запроса при бронировании отеля с запрошенными полями данных:

• Базовый (displayName, types, openingHours, formattedAddress)
• Контакт (websiteUri, nationalPhoneNumber, internationalPhoneNumber)
• Предпочтительные (reviews, priceLevel, userRatingCount)

 { "includedTypes": ["restaurant","cafe","park"], "excludedTypes":
["lodging","convenience_store"], "includedPrimaryTypes":
["restaurant","tourist_attraction","airport"], "excludedPrimaryTypes":
["lodging"], "maxResultCount": 20, "locationRestriction": { "circle": {
"center": { "latitude": 37.7937, "longitude": -122.3965 }, "radius": 500.0 } } }

Пример запроса при поиске недвижимости с запрошенными полями данных:

• Базовый (displayName, types, openingHours, formattedAddress)

 { "includedTypes": ["school","transport","bus","convenience_store"],
"excludedTypes": ["lodging"], "includedPrimaryTypes":
["restaurant","tourist_attraction","airport"], "excludedPrimaryTypes":
["lodging"], "maxResultCount": 20, "locationRestriction": { "circle": {
"center": { "latitude": 37.7937, "longitude": -122.3965 }, "radius": 500.0 } } }

3. Добавьте интерактивность с помощью Динамических карт и Directions API.

• Актуальные этапы и шаги, полученные с помощью запроса к Directions API. * Используйте время в следующем разделе.

4. Показ подробной информации о месте при взаимодействии

1. Описание. displayName, types, rating, userRatingCount, priceLevel.

   Время – из предыдущего запроса Directions API.

2. Отзывы: reviews[i].author, reviews[i].rating,reviews[i].text.

3. Изображения. Во время неограниченного предварительного доступа к Nearby Search (New) API вам нужно будет запрашивать информацию о местах с помощью place.id, чтобы получить photo_reference, а затем запрашивать по одному изображению за раз.

Количество запросов и связанные с ними расходы

• Maps JavaScript API: одна карта при загрузке.
• Places Autocomplete API: один запрос на каждый введенный символ (при использовании виджета автозаполнения мест). Это можно настроить.
• Nearby Search (New) API: один запрос на каждые 20 показанных мест. Разные тарифы в зависимости от данных о местах, которые входят в ответ на запрос.
• Directions API: один запрос на каждое место, выбранное пользователем.
• Place Photo API – один запрос на каждое показанное фото.

Заключение

Поиск мест поблизости – это очень полезная функция. В этой демонстрационной реализации есть много функций, которые вы, скорее всего, захотите включить при создании такого интерфейса на платформе Google Карт с помощью специальных возможностей Nearby Search (New) API .

Дальнейшие действия

Дополнительные сведения

• Веб-компоненты в Maps JavaScript API
• Оптимизация автозаполнения мест
• Другие сервисы Places
• Оставьте отзыв ниже.

Авторы

Основные авторы:

Тома Англаре (Thomas Anglaret) | инженер по решениям платформы Google Карт