В этом документе вы узнаете, как использовать 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 направлений.
Обзоры :
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