Оглавление
В API Google Адресов поддерживает поиск мест, автозаполнение, поиск объектов поблизости, информацию о компаниях и другие функции, основанные на геолокации. Настоящая сложность заключается в том, чтобы определить, какой сервис «Места» подходит для конкретной задачи, какие поля стоит запрашивать и как эти решения влияют на стоимость.
Переход Google на Places API (новая версия) меняет подход разработчиков к обработке запросов, выбору полей, данным ответов и выставлению счетов. Старые схемы реализации не всегда удается без проблем перенести, особенно когда в игру вступают маски полей и ценообразование на основе SKU.
Правильная настройка зависит от того, что вы разрабатываете. Для поиска местоположения внутри приложения может потребоваться лишь небольшой набор сведений о месте. Команда, использующая API Google Places для привлечения потенциальных клиентов В разных городах может потребоваться разный рабочий процесс. Одинаковый подход к обоим вариантам использования может привести к ненужным затратам и дополнительной нагрузке на API.
Прежде чем выбрать конечную точку или оценить ежемесячный объем использования, полезно разобраться в том, как Google организует поиск по местам, выбор полей, выставление счетов и квоты. Эти сведения также помогут понять, в каких случаях официальный API Places подходит для решения задачи, а в каких целесообразнее использовать отдельный рабочий процесс с бизнес-данными.
Краткий ответ: Как работает API Google Places
- Ищите места с помощью текстового поиска или поиска поблизости.
- Получите подробную информацию, фотографии и идентификаторы мест для конкретных локаций.
- Используйте функцию автозаполнения для предложения вариантов мест по мере ввода текста пользователями.
- Настройте проект Google Cloud, систему биллинга и ключ API с ограниченными правами доступа.
- Используйте маски полей для управления возвращаемыми данными и выставлением счетов.
- Стоимость зависит от вида услуги, запрашиваемых полей и объема использования.
- Для больших объемов бизнес-данных или дополнительных полей контактов может лучше подойти другой рабочий процесс обработки данных.
Что такое API Google Places?
API Google Places является частью платформы Google Maps Platform. Он предоставляет разработчикам программный доступ к информации о компаниях, достопримечательностях, адресах, географических местоположениях и других объектах, включенных в базу данных Google Places.
В настоящее время Google заявляет, что API «Места» (новое) предоставляет данные о местоположении более 200 миллионов объектов. Разработчики могут использовать эту информацию для добавления на веб-сайты, в мобильные приложения и другое программное обеспечение таких функций, как поиск объектов, обнаружение ближайших объектов, автозаполнение, подробная информация об объектах и фотографии.
Типичный запрос начинается с поискового запроса, географического района или известного идентификатора места (Place ID). Google возвращает структурированную информацию о месте в зависимости от типа запроса и полей, выбранных разработчиком.
Например, приложение для поиска ресторанов может использовать функцию «Поиск поблизости», чтобы найти рестораны в окрестностях местоположения пользователя. После того как пользователь выберет ресторан, приложение может запросить «Сведения о месте», чтобы получить такую информацию, как адрес, рейтинг, часы работы, номер телефона или отзывы.
Какие данные может возвращать API Google Places?
Доступные поля зависят от запроса и от полей, включенных в маску полей. API Places (новая версия) может возвращать такую информацию, как:
| Тип данных | Примеры полей | О чем идет речь |
|---|---|---|
| Идентичность | Название населённого пункта, Идентификатор населённого пункта, Тип населённого пункта | Определяет место и его категорию. |
| Местоположение | Адрес, географические координаты | Показывает, где находится это место. |
| Сведения о компании | Информация о компании, номер телефона, веб-сайт, часы работы | Содержит оперативную информацию и контактные данные. |
| Информация о клиенте | Рейтинг, отзывы, информация о цене | Содержит данные о рейтингах, отзывах и ценах. |
| СМИ | Фотографии | Возвращает доступные изображения, связанные с этим местом. |
| Доступность | Информация о доступности | Описывает поддерживаемые функции доступности. |
| Варианты обслуживания | Доставка, питание в ресторане, самовывоз | Отображает доступные варианты обслуживания, если они поддерживаются. |
Google группирует эти поля по различным ценовым уровням. Некоторые базовые поля относятся к SKU с более низкой стоимостью, тогда как такие поля, как оценки, часы работы и отзывы, могут привести к применению SKU с более высокой стоимостью. Google объясняет взаимосвязь между полями и выставлением счетов в своём Документация по полям данных API «Места». Запрашивайте только те поля, которые необходимы приложению, поскольку выбор полей может повлиять на SKU для выставления счета.
API «Места» (новое) также требует указания маски полей для запросов «Сведения о месте», «Текстовый поиск» и «Поиск поблизости». Необходимо указать как минимум одно поле. Запрос без маски полей приводит к ошибке.
Как Places API вписывается в платформу Google Maps
API «Места» обрабатывает информацию о местах, но это лишь одна из составляющих платформы Google Maps.
Разработчик может воспользоваться API Places для поиска компании, а затем использовать другой сервис Google Maps Platform для решения другой задачи. Например, API Geocoding позволяет преобразовать адрес в координаты, а сервисы прокладки маршрутов — рассчитать маршрут или время в пути между двумя точками.
В рамках самого Places API основные сервисы отвечают за различные этапы процесса поиска мест:
- Поиск по тексту находит места по текстовым запросам.
- Поиск поблизости находит объекты в пределах заданного географического района.
- Сведения о месте извлекает информацию об известном месте.
- Автозаполнение предлагает варианты по мере ввода текста пользователем.
- Разместить фотографии извлекает доступные изображения, связанные с местом.
Google рекомендует использовать Сведения о месте когда идентификатор места уже известен, поскольку нет необходимости отправлять еще один запрос на поиск того же места.
Поиск компаний по городу, поле автозаполнения и запрос подробной информации об одном известном месте — для каждого из этих действий требуется свой метод API Places.
Как работает API Google Places
API Google Places использует различные методы в зависимости от имеющихся у вас исходных данных и типа данных о местах, которые вам нужны.
Для письменного запроса, набора координат и известного идентификатора объекта (Place ID) требуются разные методы. В настоящее время API Places (новая версия) предоставляет для этих задач следующие функции: текстовый поиск, поиск поблизости, подробную информацию об объекте, автозаполнение и фотографии объекта.
Поиск по тексту
Функция «Поиск по тексту» позволяет находить места по текстовому запросу, например по названию компании, категории, адресу или фразе, такой как pizza in New York.
Функция «Поиск по тексту» (новая) использует HTTP-запрос методом POST и возвращает соответствующие объекты «Место». С помощью дополнительных параметров можно сузить результаты поиска по местоположению, типу места, режиму работы, рейтингу или ценовому диапазону.
В настоящее время Google выдает до 60 результатов на всех страницах и отмечает, что при одинаковых запросах список результатов не всегда может быть одинаковым.
Поиск поблизости
Функция «Поиск поблизости» позволяет находить места в пределах заданного географического района.
В запросе используются широта, долгота и радиус, а затем результаты фильтруются по одному или нескольким типам мест. Например, приложение может найти рестораны, расположенные на заданном расстоянии от отеля.
Функция «Поиск поблизости» (новая) также использует HTTP-запрос POST и требует маску поля для возвращаемых данных.
Сведения о месте
Функция «Сведения о месте» извлекает информацию об одном известном месте по его идентификатору.
Обычный алгоритм действий выглядит следующим образом:
- Найдите место с помощью текстового поиска, поиска поблизости или автозаполнения.
- Сохранить его идентификатор местоположения.
- Запрашивайте только те данные, которые необходимы приложению.
Это позволяет избежать повторного поиска, если место уже определено.
Автозаполнение
Функция автозаполнения предлагает варианты мест по мере ввода текста пользователем в поле поиска.
Токен сеанса позволяет объединить запросы пользователя в один поисковый сеанс для целей выставления счетов. Для каждого нового поиска следует использовать новый токен, а сеанс должен завершаться совместимым запросом «Подробная информация о месте» или «Проверка адреса».
Фотографии мест и идентификаторы мест
Функция «Фотографии по месту» извлекает изображения, связанные с тем или иным местом, когда photos поле возвращается в результате текстового поиска, поиска поблизости или в разделе «Сведения о месте».
Идентификаторы мест (Place IDs) позволяют идентифицировать конкретные места, чтобы на них можно было ссылаться в различных поддерживаемых сервисах Google Maps Platform.
Например, приложение может найти объект с помощью текстового поиска, сохранить его Place ID, а затем запросить подробную информацию об объекте, не повторяя исходный поиск.
API «Места» (новый) и API «Места» (старая версия)
1 марта 2025 года компания Google перевела исходный API Places в статус «Устаревший». Существующие проекты по-прежнему могут использовать его, однако в новых проектах Cloud невозможно включить устаревшие сервисы.
API «Места» (новая версия) теперь является версией, которую Google рекомендует для новых разработок. Изменения затрагивают методы запросов, выбор полей, структуру ответов, аутентификацию и выставление счетов.
Что изменилось в Places API (новинки)?
Функции «Поиск по тексту» и «Поиск поблизости» теперь используют HTTP-запрос POST вместо шаблона на основе GET, который применялся в старой версии.
API «Места» (новое) также поддерживает ключи API и OAuth, возвращает ответы в формате JSON и требует указания масок полей для функций «Сведения о месте», «Текстовый поиск» и «Поиск поблизости».
У функции «Найти место» нет прямой новой версии. Google перенаправляет такие запросы в «Текстовый поиск».
Полевые маски и изменения в ответах
Маски полей — одно из основных отличий Places API (новая версия) от старого API.
Для функций «Сведения о месте», «Текстовый поиск» и «Поиск поблизости» в запросе необходимо указать как минимум одно поле для возврата результатов. Если не указать маску поля, запрос завершится с ошибкой.
Выбор полей также влияет на выставление счетов, поскольку Google присваивает поля с данными о местоположении различным SKU. В разделе «Ценообразование», расположенном далее в этой статье, эта взаимосвязь объясняется более подробно.
Изменились также объекты ответов. В Places API (новая версия) для имен полей используется формат camelCase вместо формата snake_case, который широко применялся в ответах старой версии.
К примеру:
форматированный_адресстановитсяформатированный адресbusiness_statusстановитсястатус бизнесаформатированный_номер_телефонастановитсянациональный телефонный номерgeometry.locationстановитсяместоположение
Функции «Поиск по тексту» и «Поиск поблизости» также выдают результаты в виде локации массив, а не устаревшая версия результаты массив. Информация о состоянии и ошибках теперь передается с использованием стандартных кодов ответов HTTP и сообщений вместо устаревших полей, таких как статус а также сообщение_об_ошибке.
Эти изменения имеют важное значение в тех случаях, когда существующие приложения анализируют ответы в формате Legacy или используют устаревшие названия полей.
Что необходимо знать пользователям устаревшего API о переходе на новую версию
Для миграции, как правило, требуется нечто большее, чем просто смена конечной точки. Google предоставляет Руководство по миграции API «Места» в котором рассматриваются основные различия между Legacy API и Places API (новой версией).
Сначала проверьте следующие области:
- Переместить поиск «Найти место» в раздел «Текстовый поиск (новый)».
- Измените запросы «Поиск по тексту» и «Поиск поблизости» с метода GET на метод POST.
- Добавьте необходимые маски полей.
- Обновите код, который считывает поля ответа Legacy.
- Проверьте SKU, используемый в каждом запросе.
Также убедитесь, что в проекте включен API «Места» (новая версия) и что он разрешен в настройках ограничений ключа API.
Если во время тестирования необходимо одновременно запускать запросы «Legacy» и «New», следует разделить эти два потока. Google рекомендует использовать отдельные ключи API во время миграции.
Существующие устаревшие интеграции пока могут продолжать работать, но в новых проектах следует использовать Places API (новая версия).
Руководство по API Google Places: настройка и первый запрос
Для использования Places API (New) необходимо сначала подключить проект Google Cloud к учетной записи для выставления счетов. Перед отправкой запросов с аутентификацией в проекте должна быть включена функция Places API (New).
Настройка базового запроса к веб-сервису состоит из пяти этапов: выбор облачного проекта, включение API, создание ключа API, ограничение доступа к ключу и отправка запроса с полями, результаты по которым необходимо получить.
Создать или выбрать проект Google Cloud
Каждый запрос в Google Maps Platform относится к какому-либо проекту Google Cloud.
Вы можете создать новый проект или использовать уже существующий. Для выбранного проекта также требуется активная учетная запись для выставления счетов. Google использует проект для отслеживания доступа к API, объема использования, квот и сборов.
Ведение отдельных проектов также может быть целесообразно в тех случаях, когда для сред разработки, тестирования и производственной среды требуются разные учетные данные или меры контроля доступа.
После выбора нужного проекта в консоли Google Cloud можно включить Places API (New).
Включить API «Места» (новое)
Прежде чем приложение сможет вызывать методы веб-сервиса Places API (New), для проекта необходимо включить этот API.
В консоли Google Cloud:
- Выберите проект, который хотите использовать.
- Открытым API и сервисы.
- Найти API «Места» (новое) в библиотеке API.
- Включите эту функцию для проекта.
Это различие имеет значение для старых проектов, поскольку Places API (Legacy) и Places API (New) представляют собой отдельные сервисы. Для проекта, в котором ранее использовался Legacy API, может потребоваться включение Places API (New), чтобы новые конечные точки начали работать.
Настройка ключа API и ограничения
Ключ API идентифицирует проект Google Cloud, отправляющий запрос.
Google требует, чтобы функция выставления счетов была включена, прежде чем можно будет использовать Places API (New) для реальных запросов. Если вы просто следуете инструкциям по настройке и пока не хотите привязывать учетную запись для выставления счетов, вы можете остановиться до создания ключа и вернуться к этому шагу позже.
Если функция выставления счетов включена, создайте ключ API в консоли Google Cloud и установите для него ограничения, прежде чем использовать его в приложении.
В случае запросов к Places API, выполняемых на стороне сервера, ограничение по IP-адресу позволяет ограничить использование ключа только разрешенными серверами. Вы также можете настроить ограничение ключа таким образом, чтобы он работал только с Places API (New) и другими сервисами Google Maps Platform, которые действительно необходимы вашему приложению.
Google также требует, чтобы запросы к веб-сервису Places API отправлялись по протоколу HTTPS. Отсутствие ключа, неверное ограничение или неподдерживаемая конфигурация могут привести к возврату REQUEST_DENIED ответ.
Примеры использования API Google Places: отправьте свой первый запрос на текстовый поиск
«Текстовый поиск» — это простой пример использования API Google Places, позволяющий понять формат запроса, заголовок с ключом API и маску полей.
API «Места» (новое) отправляет запросы на текстовый поиск по адресу:
https://places.googleapis.com/v1/places:searchText
В запросе используется метод HTTP POST. Текст для поиска указывается в теле запроса в формате JSON, а ключ API и маска поля могут передаваться через заголовки запроса.
Простой запрос может выглядеть следующим образом:
curl -X POST \
-H "Content-Type: application/json" \
-H "X-Goog-Api-Key: YOUR_API_KEY" \
-H "X-Goog-FieldMask: places.id,places.displayName,places.formattedAddress" \
-d '{ "textQuery": "dentists in Chicago" }' \
"https://places.googleapis.com/v1/places:searchText"
Этот запрос ищет dentists in Chicago и просит Google выдать только:
- Идентификатор места
- отображаемое имя
- адрес в форматированном виде
При успешном выполнении запроса возвращаются соответствующие объекты Place внутри локации массив. Набор полей, включённых в каждый результат, зависит от маски полей, использованной в запросе.
Использование маски с ограниченным полем упрощает чтение результатов и позволяет избежать запроса данных, которые приложению не нужны.
Актуальную информацию о параметрах запросов, поддерживаемых полях, квотах и изменениях в API см. на официальном сайте Документация по API Google Places.
Пример использования API Google Places: получение сведений об объекте
В результате запроса «Поиск по тексту» может быть возвращен идентификатор места (Place ID) для каждого найденного местоположения. Как только приложение узнает идентификатор места, оно может воспользоваться функцией «Сведения о месте» (Place Details), чтобы запросить информацию об этом конкретном месте без проведения повторного поиска.
Запрос имеет следующий формат:
https://places.googleapis.com/v1/places/PLACE_ID
Например:
curl -X GET -H "Content-Type: application/json" -H "X-Goog-Api-Key: YOUR_API_KEY" -H "X-Goog-FieldMask: id,displayName,formattedAddress" "https://places.googleapis.com/v1/places/PLACE_ID"
Заменить PLACE_ID с идентификатором, возвращаемым функцией «Текстовый поиск», «Поиск поблизости» или другим поддерживаемым методом Places.
Обратите внимание, что в маске поля «Сведения о месте» используется id, displayNameи formattedAddress а не places.id, places.displayNameи places.formattedAddress. Функция «Place Details» возвращает один объект Place, тогда как функция «Text Search» возвращает объекты Place, содержащиеся в локации массив.
Выберите нужные поля
Для функций «Сведения о месте», «Текстовый поиск» и «Поиск поблизости» в Places API (новая версия) требуется указать маску поля. Если поле не указано, запрос завершается с ошибкой.
Для текстового поиска маска поля может выглядеть следующим образом:
places.displayName,places.formattedAddress
Если приложению также требуется веб-сайт и рейтинг, маску поля можно расширить:
places.displayName,places.formattedAddress,places.websiteUri,places.rating
Google также поддерживает * в качестве подстановочного знака для всех доступных полей, однако не рекомендуется использовать подстановочный знак в производственной среде. Запрос ненужных полей может увеличить объем возвращаемых данных и привести к переходу запроса в тарифный план с более высокой стоимостью.
Ограничьте маску поля только теми данными, которые действительно используются приложением. Выбор полей влияет как на объем ответа, так и на затраты на запрос.
В приведенном ниже разделе, посвящённом ценообразованию, объясняется, как эти варианты полей соотносятся с SKU API Google Places.
Используйте Outscraper Парсер Google Maps для сбора бизнес-данных с помощью рабочего процесса без программирования, без необходимости настраивать отдельные запросы к Places API.
Цены на API Google Places и условия бесплатного использования
API Google Places использует модель оплаты по факту использования. Каждый запрос тарифицируется по конкретному SKU, а стоимость зависит от используемого метода, запрашиваемых полей и количества ежемесячных событий, подлежащих оплате.
Google больше не использует старую систему периодических кредитов $200 для Maps Platform. В рамках текущей модели для каждого SKU установлен собственный ежемесячный лимит бесплатного использования. Эти лимиты обнуляются в начале каждого месяца.
Как работают SKU в API Google Places
SKU — это категория для выставления счетов, привязанная к запросу Places API.
API Places (новое) разделяет многие запросы на тарифные планы, такие как Essentials, Pro и Enterprise. Запрашиваемые поля могут привести к переходу запроса в SKU с более высокой стоимостью.
Например, «Сведения о месте» могут выставляться в счёт под разными SKU в зависимости от запрашиваемых полей:
- Основная информация о месте включает в себя ежемесячный лимит бесплатного использования в размере 10 000 событий.
- Ежемесячный лимит бесплатного использования для Подробная информация о месте Pro составляет 5 000 событий.
- Для Сведения о месте: «Enterprise», ежемесячный лимит бесплатного использования составляет 1 000 событий.
После исчерпания лимита бесплатного использования тариф рассчитывается за каждую 1 000 событий и снижается при увеличении ежемесячного объема.
Функции «Поиск по тексту» и «Поиск поблизости» имеют схожую структуру.
Что касается первого уровня платного использования, Google в настоящее время указывает следующие тарифы на официальном сайте Страница с ценами на Google Maps Platform:
*Эти цифры относятся к первому ценовому уровню, указанному на странице глобальных тарифов Google. При более высоких ежемесячных объемах применяются более низкие ставки за 1 000.
Google также предлагает некоторые SKU, доступные только по идентификаторам, с неограниченным бесплатным использованием, в том числе «Place Details Essentials (только по идентификаторам)» и «Text Search Essentials (только по идентификаторам)».
Текущие лимиты бесплатного использования
Право на бесплатное использование привязано к отдельным SKU, а не к единому общему кредиту в долларах.
Например:
- Запросы автозаполнения: 10 000 бесплатных событий в месяц
- Основные сведения о месте: 10 000
- Place Details Pro: 5 000
- Text Search Pro: 5 000
- Nearby Search Pro: 5 000
- Сведения о месте: количество предприятий — 1 000
- Text Search Enterprise: 1 000
- Поиск поблизости — предприятия: 1 000
Некоторые сервисы, доступные только по идентификатору, предоставляют возможность неограниченного бесплатного использования.
В результате оценка стоимости в большей степени зависит от конкретного запроса, чем в рамках прежней системы начисления кредитов. Два приложения, выполняющие одинаковое количество вызовов Places API, могут получить разные счета, если они запрашивают разные поля или используют разные методы.
Как обязательные для заполнения поля влияют на выставление счетов
Маски полей определяют не только размер ответа.
В случае функций «Сведения о месте», «Текстовый поиск» и «Поиск поблизости» Google выставляет счет за запрос в соответствии с самым высоким уровнем SKU, представленным в запрашиваемых полях. Если маска полей включает поля как из пакета Essentials, так и из пакета Pro, счет за запрос выставляется по тарифу пакета Pro.
Например, приложению, которому требуются только идентификатор объекта и адрес, могут не понадобиться те же поля, что и приложению, запрашивающему оценки, часы работы, отзывы и дополнительные атрибуты объекта.
Таким образом, выбор поля становится частью расчета затрат.
Не запрашивайте по умолчанию все доступные поля. Начните с полей, необходимых для работы функции, и добавляйте остальные только в том случае, если они служат четкой цели.
Как сеансы автозаполнения влияют на выставление счетов
Оплата функции автозаполнения может производиться за каждый запрос или в рамках сеанса.
Без токена сеанса каждый запрос автозаполнения тарифицируется отдельно в рамках SKU «Запросы автозаполнения».
Сессия объединяет запросы пользователя на автозаполнение с тем запросом, который завершает выбор. Типичная сессия начинается с одного или нескольких вызовов функции автозаполнения и заканчивается действием «Детали объекта (Новый)» или «Проверка адреса». Для каждого нового поиска пользователя следует использовать новый токен сессии.
Для сеансов, завершающихся запросом «Основная информация о месте», Google в настоящее время выставляет счета за первые 12 запросов автозаполнения по отдельности. Запросы, следующие за 12-м, учитываются в рамках «Использования сеанса автозаполнения», которое предоставляется бесплатно. Завершающий запрос «Основная информация о месте» по-прежнему оплачивается по отдельному SKU.
Прерванные сессии не подпадают под данную схему расчета. Если пользователь так и не завершит сессию на странице «Подробности о месте» или при проверке адреса, стоимость вызовов функции автозаполнения будет рассчитываться по тарифу «за запрос».
Как рассчитать расходы на использование API Google Places
Для составления точной сметы затрат следует исходить из фактического потока запросов, а не из общего числа пользователей.
Проверьте:
- Какой метод API Places будет вызван.
- Сколько раз вызывается метод в ходе одного действия пользователя.
- Какие поля входят в маску полей.
- Какой SKU соответствуют эти поля.
- Сколько оплачиваемых мероприятий ожидается ежемесячно.
- Какая часть этого объема использования укладывается в рамки бесплатного месячного лимита для данного SKU.
- Группируются ли запросы автозаполнения в правильно завершённые сессии.
Например, приложение, которое ежемесячно отправляет 20 000 запросов «Place Details Essentials», сначала будет использовать ежемесячный бесплатный лимит в 10 000 событий. Остальные 10 000 событий будут относиться к платному тарифному плану.
При текущей ставке первого уровня в размере $5 за 1 000 событий эти 10 000 платных запросов обойдутся примерно в $50 до учета налогов и других расходов на использование Maps Platform.
Расчет изменяется, если маска поля определяет SKU версии Pro или Enterprise, поэтому ожидаемые поля должны быть включены в калькуляцию затрат с самого начала.
Когда API Google Places является подходящим инструментом, а когда — нет
API Google Places хорошо подходит для случаев, когда информация о местах является частью функционала приложения. Поле поиска, инструмент поиска магазинов, приложение для путешествий, интерфейс доставки или функция поиска ближайших предприятий могут запрашивать информацию о местах, когда это необходимо пользователю.
Требования меняются, когда основной целью является формирование бизнес-набора данных. Сбор записей по многим категориям, городам или регионам представляет собой иной рабочий процесс, чем поиск мест внутри приложения.
Более подробное сравнение официального доступа к API и извлечения данных в больших объемах см. в API Google Maps против веб-парсинга.
Когда API Google Places работает нормально
Компания Google разработала API Places (новая версия) с учетом функций приложений, использующих геолокацию.
Это идеальный вариант, когда приложению необходимо:
- поиск мест по данным, введенным пользователем
- найти ближайшие предприятия или достопримечательности
- предлагать варианты, пока пользователь вводит текст
- получить информацию об известном месте
- отобразить фотографии места
- использовать идентификаторы мест (Place IDs) во всех поддерживаемых сервисах Google Maps Platform
Например, приложение для бронирования отелей может показывать рестораны, расположенные рядом с выбранным отелем. Приложение для доставки может использовать функцию автозаполнения, чтобы помочь клиенту ввести адрес назначения. Сервис поиска магазинов может отобразить информацию о конкретном филиале после того, как пользователь его выберет.
Эти запросы обычно выполняются в рамках взаимодействия внутри приложения. Разработчик контролирует, какой метод вызывается, какие поля возвращаются и как результаты отображаются пользователю.
В документации Google описывается интерфейс Places API (новый) в контексте таких функций приложений, как поиск мест, просмотр сведений, автозаполнение и определение местоположения.
Когда вам нужны бизнес-данные в больших объемах
Для некоторых проектов требуется набор данных, а не функция поиска по местоположению.
Вместо того, чтобы спрашивать:
Какие рестораны находятся рядом с этим пользователем?
Исследовательской группе могут понадобиться:
Какие рестораны работают в этих 50 городах?
Подобная картина наблюдается в разных командах:
- Разработчики может потребоваться поиск места или подробной информации внутри приложения.
- Специалисты по маркетингу для проведения маркетинговых исследований может потребоваться информация о компаниях с разбивкой по категориям и местоположению.
- Отделы продаж могут потребоваться данные о компаниях, соответствующие географическим критериям или критериям, связанным с компанией.
- Специалисты по данным могут потребоваться структурированные записи для анализа, информационных панелей или внутренних систем.
Когда работа предполагает сбор сотен или тысяч деловых документов, процесс переходит от поиска отдельных записей к сбору данных.
Информацию об исследованиях рынка см. Какие данные о компаниях из Google Maps следует собирать для анализа рынка прежде чем определить, какие поля должны входить в ваш набор данных.
Вариант сбора бизнес-данных без программирования
Команды, которым не требуется реализовывать функцию поиска мест, могут использовать Outscraper Парсер Google Maps для сбора бизнес-данных без настройки запросов в Google Cloud и написания кода API.
Пользователи могут осуществлять поиск по категориям и местоположению, запускать сбор данных через веб-интерфейс и экспортировать результаты для проведения исследований, поиска новых клиентов или анализа.
Для разработчиков и специалистов по работе с данными, которым требуется программный доступ, Outscraper API Google Maps Places представляет собой отдельный сервис от сервиса Google API «Места» (новое). Он поддерживает массовый сбор бизнес-данных. См. Документация по API Outscraper для получения подробной информации о запросе.
Приложение, в котором требуется поиск ближайших мест, предъявляет иные требования к данным, чем команда, занимающаяся созданием многократно используемого набора бизнес-данных.
Используйте Outscraper API Google Maps Places когда вам требуются бизнес-документы из различных категорий или из разных регионов для проведения исследований, продаж, анализа или других рабочих процессов, связанных с данными.
When You Need Additional Business or Contact Data
Google Places API can return addresses, phone numbers, websites, ratings, reviews, opening hours, business status, and other place fields.
For prospecting or market research, that may still leave gaps. Teams may also need email addresses, contact details, social profiles, or other company information before a record is ready to use.
If you need to add contact and company information after collecting place data, see the guide to Дополнение данных о местах в Google Maps.
A typical workflow is:
- Find businesses by category and location.
- Keep the fields needed for targeting.
- Add contact or company data.
- Export the records for sales, research, or another system.
Outscraper supports business-data collection through both no-code and API workflows, with additional enrichment options for emails, contacts, and social profiles.
Google Places API fits place search and place details inside applications. Business-data workflows that need contact data, enrichment, or export usually require additional tools.
Google Places API Limits, Quotas, and Billing Risks
A Places API setup can work in testing and still run into cost, quota, or access problems once usage increases.
Google applies quotas by API method and project rather than through one shared daily limit. Usage, quotas, errors, and billing can be checked in Google Cloud Console.
Request Only the Fields You Need
Field masks affect both the response and the billing SKU.
If a request includes Pro-level fields, Google can bill the request at the Pro rate even when lower-cost fields are also included. Keep the field mask limited to data the application actually uses.
Use the Right Search Method
Text Search works from a written query. Nearby Search works from a defined geographic area and place-type criteria.
Например:
кофейни в Бостонеfits Text Search.- restaurants within a set radius fit Nearby Search.
Choosing the right method reduces unnecessary requests and extra filtering.
Manage Autocomplete Sessions Correctly
Autocomplete can generate several requests while a user types.
Use a new session token for each search session and complete the session with a compatible Place Details or Address Validation request. Abandoned or incorrectly configured sessions can be billed as separate requests.
Keep Legacy and New Requests Separate
Places API (Legacy) and Places API (New) use different request formats, field names, and response structures.
Do not mix Autocomplete session tokens between Legacy and New requests. Check older integrations before moving production traffic to Places API (New).
Restrict Your API Keys
Google recommends restricting API keys by application and API.
For server-side requests, IP restrictions can limit where the key is used. API restrictions can limit the same key to Places API (New) and other required services.
An incorrectly configured key can also cause ЗАПРОС_ОТКЛОНЕН errors, so restrictions should be tested before production use.
Set Quotas and Billing Alerts
Google Cloud Console can track traffic, errors, quotas, and spending.
Set quota limits and billing alerts before request volume grows. Billing alerts warn you when spending reaches selected thresholds, but they do not automatically stop API usage.
Final Checklist: Before You Use the Google Places API
- Choose the Places API method that matches the task.
- Use Places API (New) and request only the fields you need.
- Check the SKU, free usage cap, and expected monthly cost.
- Restrict the API key and set quotas or billing alerts.
- Decide whether you need app-based place lookup or bulk business-data collection.
Использовать Outscraper Google Maps Places API to collect business records across multiple locations or categories.
Часто Задаваемые Вопросы
Наиболее частые вопросы и ответы
API Google Places не является полностью бесплатным. Google использует модель оплаты по факту использования с ежемесячными лимитами бесплатного использования для отдельных SKU. Например, для запросов автозаполнения и «Place Details Essentials» в настоящее время предусмотрено 10 000 бесплатных операций в месяц, тогда как для других SKU установлены более низкие лимиты.
API «Места» используется для поиска мест и получения информации о компаниях, достопримечательностях и других объектах. API «Геокодирование» в основном используется для преобразования адресов в координаты или координат обратно в адреса. Оба API могут работать с идентификаторами мест (Place ID), но они решают разные задачи, связанные с данными о местоположении.
API «Места» предоставляет данные о местах посредством HTTP-запросов. API «Карты» для JavaScript используется для добавления интерактивных карт и картографических функций, работающих в браузере, на веб-сайты. Библиотека «Места» этого API также позволяет реализовать поиск мест и автозаполнение в веб-приложении.
Да. Для рабочего проекта Places API требуется проект Google Cloud, привязанный к учетной записи для выставления счетов. Кроме того, в проекте должен быть включен необходимый сервис Places API и должны быть указаны действительные учетные данные для аутентификации.
Идентификатор места (Place ID) — это текстовый идентификатор объекта в базе данных Google Places и в Google Maps. Его можно использовать в нескольких сервисах Google Maps Platform, включая Places API, Geocoding API, Maps JavaScript API и Routes API. Компания Google отмечает, что идентификаторы мест могут меняться со временем, и рекомендует обновлять сохраненные идентификаторы, которым более 12 месяцев.
API «Места» (новая версия) — это текущая версия, предназначенная для новых разработок. Некоторые методы устаревшей версии напрямую соответствуют новым методам, а другие были изменены. Например, метод «Поиск по тексту» (новая версия) заменяет метод «Найти место» (устаревшая версия). Существующие проекты, использующие устаревшую версию, по-прежнему поддерживаются, однако в новых облачных проектах нельзя включать службы устаревшей версии.
В текущем списке полей данных о местоположении (Place-data) API Google Places (New) отсутствует поле «Деловая электронная почта». API может возвращать такие поля, как номера телефонов и URL-адреса веб-сайтов, однако адреса деловой электронной почты не указаны в списке поддерживаемых полей Place.
