Как использовать API Google Places и получить ключ API

Что такое API Google Places

API Places — это сервис, который возвращает информацию о местах с помощью HTTP-запросов. Места в этом API обычно определяются как заведения, географические местоположения или известные достопримечательности.

В API есть пять типов запросов. Вот они:

• Поиск мест, который возвращает список мест на основе местоположения пользователя или поискового запроса.
• Сведения о месте, который предоставляет подробную информацию о конкретном месте с отзывами пользователей.
• Фотографии мест, предоставляет доступ к миллионам фотографий, связанных с местами, в базе данных Google Places.
• Обзоры мест, обеспечивает доступ к отзывам Google и их встраивание с платформы.
• Автоматизация мест предназначена для автоматического заполнения названия или адреса места по мере ввода текста пользователем.
• Автоматизация запросов предоставляет службу прогнозирования запросов для текстового географического поиска, возвращая предлагаемые запросы по мере ввода текста.

Для работы с API Places вам нужен ключ, который должен быть включен в каждый запрос API Places. Давайте выясним, что это такое и как получить ключ API Google Places. 

Как создать ключ API Google Places

Ключ API — это уникальный идентификатор, используемый для аутентификации запросов, связанных с вашим проектом, для целей использования и выставления счетов. Используя ключ API для аутентификации запросов, вы можете:

• Управлять своими API в Google Cloud Console.
• Получить доступ к данным об использовании в реальном времени и к историческим данным об использовании за 30 дней в Google Cloud Platform Console.
• Просмотреть отчеты об использовании с информацией за более чем 30 дней на портале поддержки Google Cloud.

Дополнительную информацию об отчетах, доступных для клиентов Premium-плана, см. здесь. Теперь вы можете продолжить получение ключа.

Вы всегда можете попробовать альтернативный способ добавления отзывов клиентов на свой веб-сайт. Например, есть виджет Google Reviews от Elfsight — вам не нужно беспокоиться о получении ключей API или обучении программированию.

Получите свой ключ API Places и добавьте его в свой запрос

Чтобы получить свой ключ API, вам необходимо сделать следующее:

• Откройте консоль Google Cloud Platform.
• Щелкните раскрывающийся список Project и выберите созданный для вас проект. Имя должно начинаться с Google Maps APIs for Business, Google Maps for Work или Google Maps.
• Затем нажмите кнопку меню и выберите API и службы > Учетные данные.
• На странице Учетные данные выберите Создать учетные данные > Ключи API. Там вы увидите диалоговое окно Создать ключ API, в котором будет показан ваш недавно созданный ключ.
• Закройте вкладку. Ваш новый ключ API будет указан на странице Учетные данные в разделе Ключи API.

Затем вы должны добавить ключ API в каждый запрос API Places. Используйте следующий пример и просто замените YOUR_API_KEY на свой ключ API:

https://maps.googleapis.com/maps/api/place/nearbysearch/json ?location=-33.8670522,151.1957362 &radius=500 &types=food &name=harbour &key=YOUR_API_KEY

Обратите внимание, что Google настоятельно рекомендует вам ограничить свой ключ API. Ограничения обеспечивают дополнительную безопасность и гарантируют, что с использованием вашего ключа API будут выполняться только авторизованные запросы.

Как ограничить ключ API Google Places

Существует два ограничения, и вам нужно настроить оба. Это:

• Ограничение приложения. Эта функция позволяет ограничить использование ключа API веб-сайтами, веб-серверами или мобильными приложениями. Из этой категории можно выбрать только одно ограничение.
• Ограничение API. Этот тип ограничения ограничивает использование ключа API одним или несколькими API или SDK.

Чтобы ограничить свой ключ API, вам необходимо сделать следующее:

• Откройте Google Cloud Console.
• Щелкните раскрывающийся список Project и выберите проект, содержащий ключ API, который вы хотите защитить.
• Щелкните кнопку меню и выберите API и службы > Учетные данные.
• Щелкните имя ключа API, который вы хотите создать резервную копию, на странице Credentials.
• Настройте ограничения на странице Restrict and Rename API Keys.

После того, как ограничения установлены, все, что вам нужно сделать, это нажать кнопку «Сохранить».

Использование API Google Places: примеры

Существует несколько способов использования API Google Places. Давайте рассмотрим некоторые из них.

Поиск мест

Как уже упоминалось выше, API Places позволяет вам искать информацию о местах в различных категориях. Следующий пример API Google Places показывает поисковый запрос для «Музей современного искусства Австралии»:

https://maps.googleapis.com/maps/api/place/findplacefromtext/json?input=Museum%20of%20Contemporary%20Art%20Australia&inputtype=textquery&fields=photos,formatted_address,name,rating,opening_hours,geometry&key=YOUR_API_KEY

Сведения о месте

После того как у вас есть place_id из Поиск Google Places Вы можете получить больше информации о конкретном объекте или точке интереса, инициировав запрос сведений о месте. Здесь мы видим запрос сведений о месте с использованием place_id:

https://maps.googleapis.com/maps/api/place/details/json?place_id=ChIJN1t_tDeuEmsRUsoyG83frY4&fields=name,rating,formatted_phone_number&key=YOUR_API_KEY

Фотографии места

Эта служба позволяет вам добавлять фотоконтент в ваши приложения. Он предоставляет доступ к миллионам фотографий, хранящихся в базе данных Google Places. Вот пример запроса:

https://maps.googleapis.com/maps/api/place/photo?maxwidth=400&photoreference=CnRtAAAATLZNl354RwP_9UKbQ_5Psy40texXePv4oAlgP4qNEkdIrkyse7rPXYGd9D_Uj1rVsQdWT4 oRz4QrYAJNpFX7rzqqMlZw2h2E2y5IKMUZ7ouD_SlcHxYq1yL4KbKUv3qtWgTK0A6QbGh87GB3sscrHRIQ iG2RrmU_jF4tENr9wGS_YxoUSSDrYjWmrNfeEHSGSc3FyhNLlBU&key=YOUR_API_KEY

Автоматизация определения местоположения

Это веб-сервис, который возвращает прогнозы местоположения в ответ на HTTP-запрос. Его можно использовать для предоставления функции автозаполнения для текстового географического поиска. Вот пример запроса для заведений:

https://maps.googleapis.com/maps/api/place/autocomplete/xml?input=Amoeba&types=stitution&location=37.76999,-122.44696&radius=500&key=YOUR_API_KEY

Автоматизация запросов

Эта служба используется для прогнозирования запросов для текстового географического поиска путем возврата предлагаемых запросов по мере ввода текста пользователем. Пример запроса выглядит так:

https://maps.googleapis.com/maps/api/place/queryautocomplete/json?key=YOUR_API_KEY&input=pizza+near%20par

Цены и ограничения API Google Places

Здесь Google использует модель ценообразования на основе использования. Это означает, что API платформы Google Карт оплачиваются по SKU. Использование отслеживается для каждого SKU продукта, а API может иметь более одного SKU продукта.

Существует 1000 бесплатных поисков API Places в течение 24 часов, но вы можете увеличить это количество до 150 000 бесплатных поисков в течение 24 часов, включив выставление счетов в консоли Google Cloud.

Вы можете использовать API Google Places Ознакомьтесь с документацией для получения более подробной информации обо всех ценах и ограничениях.

Часто задаваемые вопросы

Заключение

API Google Places предоставляет эффективный способ интеграции информации о местах в ваши приложения. Используя различные типы запросов, вы можете получать подробную информацию о местах, просматривать фотографии, получать прогнозы для автозаполнения и многое другое. Использование ключей API позволяет вам аутентифицировать ваши запросы и отслеживать использование ваших приложений. При правильной интеграции вы можете предоставить своим пользователям бесперебойный опыт, используя ценную информацию о местоположении.

Если у вас есть дополнительные вопросы об использовании API Google Places, мы рекомендуем ознакомиться с официальной документацией, где доступно больше информации и примеров.