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