G Maps Crawl для разработчиков

Данные Google Maps.
Встроенные в ваш рабочий процесс.

Ищите компании, читайте публичные отзывы и просматривайте фото и видео мест. Работайте с синхронным REST API или дайте своему ИИ-ассистенту доступ через MCP.

Структурированный JSON

Результаты в том же ответе

REST + MCP

Используйте своё приложение или ИИ-клиент

Единая квота API

Общая для запросов API и MCP

Выберите свои данные

API для каждого шага вашего исследования

Начните с поиска компаний, затем используйте feature ID места, чтобы запросить отзывы или элементы галереи. У каждого API свои примеры и справочник полей.

Ваш первый запрос к API

От запроса к структурированным данным

Используйте ключ API в заголовке Authorization. Изучите форматы запросов ниже, затем следуйте быстрому старту, чтобы сделать первый вызов.

Примеры запросов

Полный контракт смотрите в документации API.

curl https://gmapscrawl.com/api/v1/search \
  -H "Authorization: Bearer $GMSCRAPER_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: seattle-coffee-search-001" \
  -d '{"q":"coffee shops in Seattle","page":1,"extra":false}'

Пример пустого ответа. Реальный поиск возвращает доступные компании. Держите ключ API на стороне сервера; используйте новый ключ идемпотентности для новой работы и сохраняйте его для неизменённого повтора.

Ответ

Пример JSON
{
  "data": {
    "total": 0,
    "params": {
      "q": "coffee shops in Seattle",
      "page": 1,
      "hl": "en",
      "extra": false
    },
    "businesses": []
  },
  "request_id": "req_example",
  "schema_version": "2026-09-22"
}

API возвращает JSON в том же ответе. После таймаута повторите неизменённое тело с тем же Idempotency-Key. Тестовые учётные данные возвращают имитированные данные и не расходуют вашу квоту.

Работа со стандартным HTTP

Небольшая интеграция. Полезный процесс работы с данными.

01

Создайте ключ API

Создайте учётные данные в своём рабочем пространстве API и храните их в секретной конфигурации сервера или клиента. REST и MCP используют одну и ту же квоту API.

Открыть ключи API
02

Выберите API

Ищите по ключевому слову и местоположению. Для отзывов и фото укажите имеющийся у вас feature ID Google Maps или прочитайте place.dataId из результата поиска.

Следовать быстрому старту
03

Читайте ответ JSON

Обрабатывайте возвращённую страницу в своём приложении. Соблюдайте правила пагинации эндпоинта, проверяйте отсутствующие поля и сохраняйте ключ идемпотентности запроса для повторных попыток.

Понять пагинацию

Создайте что-то полезное

Внесите данные Maps в своё приложение

Используйте возвращённые записи как входные данные для собственных исследований, отчётности и внутренних процессов.

01

Исследование местных компаний

Найдите категорию и местоположение, затем организуйте доступные названия компаний, адреса, сайты, номера телефонов и рейтинги в своём приложении.

02

Анализ отзывов

Получите публичные отзывы о месте, чтобы изучить отзывы клиентов. Выберите единый порядок сортировки и пройдите по доступным страницам для анализа.

03

Исследование галереи места

Получите доступные ссылки на фото и видео места. Сохраняйте ссылку на исходную галерею вместе с записями, чтобы команда могла посмотреть исходный контекст.

Ваш агент подключён

Используйте те же данные через ИИ-клиент.

Подключите сервер MCP для обнаруживаемых инструментов или установите Agent Skill для переиспользуемых инструкций процесса и REST-запасного варианта.

Пример задачи для подключённого агента

«Найди одну страницу кофеен в Сиэтле. Верни доступные названия, сайты и рейтинги и укажи на отсутствующие данные.»

Запросы расходуют вашу квоту API. С тестовыми учётными данными результаты имитируются.

Спланируйте интеграцию

Поймите расход до масштабирования

Каждая успешная реальная страница, включая пустую, расходует один запрос API. REST и MCP делят ваш тариф API; квоты Online и Extension отдельные.

Держите запросы предсказуемыми

Начните с одной страницы, проверьте возвращённые поля и задайте таймаут клиента, подходящий эндпоинту. Для повторов используйте тот же Idempotency-Key с неизменённым телом запроса.

Лимиты тарифа, ограничения частоты, доступность источника и обогащение влияют на реальные запросы. Тестовые учётные данные возвращают имитированные фикстуры и не расходуют вашу реальную квоту.

Используйте страницы эндпоинтов для лимитов запросов и полей результата. На странице цен указаны текущие включённые запросы и тарифы платного превышения.

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

Какие API Google Maps доступны?

G Maps Crawl предоставляет API поиска компаний, публичных отзывов о местах и фото/галерей мест. Search возвращает записи компаний; Reviews и Photos используют feature ID Google Maps, чтобы вернуть одну страницу для конкретного места.

Можно ли использовать Python или JavaScript?

Да. API используют HTTP-запросы и JSON, поэтому их можно вызывать через Python, JavaScript, cURL или другой HTTP-клиент. Каждая страница API содержит примеры запросов и пример ответа.

Нужно ли опрашивать результат задачи?

Публичные API Search, Reviews и Photos возвращают JSON в том же ответе. Они не требуют опроса задач или настройки вебхуков. Следуйте указаниям эндпоинта по таймаутам и повторам.

Как API, MCP и Agent Skill работают вместе?

REST позволяет вашему приложению напрямую вызывать эндпоинт. MCP делает инструменты доступными совместимому ИИ-клиенту. Agent Skill предоставляет инструкции процесса и вспомогательные скрипты. Запросы REST и MCP требуют учётных данных API и расходуют вашу квоту API.

Где взять feature ID для отзывов и фото?

Используйте имеющийся feature ID Google Maps или скопируйте place.dataId из подходящей записи в массиве data.businesses API Search. Передайте это значение как fid в API Reviews или Photos.

Гарантирована ли доступность каждого поля?

Нет. Возвращённые поля зависят от источника и выбранной операции. Проверяйте отсутствующие значения и доступные отметки времени наблюдений перед использованием данных. Успешный ответ может содержать пустую страницу.

Следующий шаг

Создайте свой первый процесс работы с данными Google Maps.

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