В этом документе вы узнаете, как использовать API Nearby Search (новый) для создания простого и экономичного решения.
Опыт знакомства с местной культурой.
Функция поиска мест по местоположению показывает пользователям ключевые достопримечательности рядом с указанным вами местоположением при поиске отеля или недвижимости. Она часто включает интерактивную карту с дополнительной панелью, содержащей инструмент выбора места и галерею фотографий. Вам будут представлены различные продукты и возможности платформы Google Maps для повышения интерактивности.
Варианты использования
Теперь давайте разберемся, какие элементы интеграции локального поиска создают ценность для пользователя:
Поиск информации — Предоставьте пользователям обзор того, что находится вокруг определенного места , отображая релевантные места различных типов.
Интерактивность — Предоставьте пользователям возможность выбирать место и динамически обновлять данные.
относительно этого места.
Визуализация — предоставление отзывов о местах и фотографий.
а также время и расстояние пешком, чтобы пользователи могли быстро понять, соответствует ли это их потребностям.
Эталонная архитектура
Локальные открытия
Существует множество способов создания удобного интерфейса для поиска локальных мест. Приведенная ниже интеграция представляет собой пример пользовательского интерфейса, использующего известные API платформы Google Maps, а также некоторые новые интересные функции. Если вы хотите использовать шаблонный подход к поиску локальных мест, вы можете использовать веб-компоненты .
Пример приложения
Пример пошагового руководства
В таблице ниже вы найдете пример приложения, разбитый на этапы, а также описание технической реализации с использованием API платформы Google Maps.
1. Поиск местоположения с автозаполнением.
- Загрузка карт с помощью JavaScript API .
- Добавляет на карту запрос автозаполнения или выбранное местоположение.
2. Отображение локальных точек интереса с помощью API поиска поблизости (новый).
- Рейтинг популярности (более релевантные результаты) или рейтинг по расстоянию.
-
includedTypes,excludedTypes; если вы отель, вы можете исключить тип «размещение» и включить только подходящие типы, например: «ресторан, кафе, парк, туристическая достопримечательность». - Используйте параметры
includedPrimaryTypesиexcludedPrimaryTypesдля еще большего контроля над результатами. - `locationRestriction` позволяет избежать недостаточного количества результатов или слишком удаленных мест; в случае отсутствия результатов, перед отображением результатов, увеличьте размер круга/прямоугольника.
Пример запроса при бронировании отеля с запрашиваемыми полями данных:
- Basic (
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 } } }Пример запроса при поиске недвижимости с указанием необходимых полей данных:
- Basic (
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. Добавьте интерактивность с помощью API динамических карт и маршрутов.
- Актуальная информация о пройденном расстоянии и количестве шагов получена с помощью запроса к API Directions . * В следующем разделе используйте время.
4. Отображайте подробную информацию о месте при взаимодействии с пользователем.
Описание :
displayName,types,rating,userRatingCount,priceLevel.Время : получено из предыдущего запроса к API Directions.
Отзывы :
reviews[i].author,reviews[i].rating,reviews[i].text.Изображения : во время неограниченного предварительного просмотра API поиска поблизости (нового) вам потребуется запросить сведения о местах, используя
place.id, чтобы получить photo_reference , а затем запрашивать по одному изображению за раз в удобном для вас режиме.
Количество запросов и связанные с ними затраты
- API JavaScript для работы с картами : 1 карта при загрузке приложения.
- API автозаполнения Places: 1 запрос на каждый введенный символ (при использовании виджета автозаполнения ), можно настроить.
- API поиска поблизости (новый) : отображается 1 запрос на каждые 20 мест. Разная стоимость в зависимости от данных о местах , содержащихся в ответе на запрос.
- API для построения маршрутов : 1 запрос для каждого места, выбранного пользователем.
- API для размещения фотографий : 1 запрос для каждой отображаемой фотографии.
Заключение
Возможность поиска локальных объектов — это мощный способ повышения ценности для пользователя. В этой демонстрационной версии реализовано множество функций, которые вы, вероятно, будете использовать при создании подобного сервиса на платформе Google Maps, благодаря специальным возможностям API Nearby Search (New) .
Следующие шаги
Рекомендуемая дополнительная литература:
- Веб-компоненты в JavaScript API карт
- Оптимизация автозаполнения мест
- Другие места Услуги
- Оставьте свой отзыв ниже.
Авторы
Основные авторы:
Томас Англаре | Инженер по решениям для платформы Google Maps