Инструкция по Google API

Google API: Карты — Сведения о компании по ID

Получайте подробные публичные данные по сущности «Карты» из Google по известному идентификатору для карточек, проверки и обогащения.

Операция «Сведения о компании по ID» подходит, когда объект уже найден и продукту нужен его актуальный публичный контекст.

Метод GET
Сущность Карты
Версии 1
Что делает этот эндпоинт

Что можно сделать с этим API-методом

Сначала оцените результат и сценарии применения, затем переходите к параметрам и рабочему примеру запроса.

Результат запроса

Ответ содержит доступные поля объекта «Карты» в нормализованной V2 или исходной V1 структуре.

Когда использовать

Операция «Сведения о компании по ID» подходит, когда объект уже найден и продукту нужен его актуальный публичный контекст.

Типовые сценарии использования

Обогащение карточек

Добавляйте публичные поля Google к уже известным объектам продукта.

Проверка данных

Сверяйте идентификаторы и актуальный публичный контекст перед дальнейшей обработкой.

Подготовка аналитики

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

Доступные версии

Версия ответа

Обе версии решают одну и ту же задачу и принимают одинаковые параметры. Переключатель нужен, чтобы сравнить структуру ответа и выбрать версию, которую ожидает ваш клиент.

Версия ответа V2

Переключайте версии на этой странице, чтобы сравнивать структуру ответа без смены URL инструкции.

V1 Недоступно

Что остается одинаковым

Аутентификация, обязательные параметры и форма запроса одинаковы для V1 и V2. Версия задаётся в пути запроса и определяет структуру ответа.

Что меняется между версиями

Главное отличие — envelope ответа. Для новых интеграций лучше использовать V2, а V1 оставлять только для совместимости с уже существующей клиентской интеграцией.

Как использовать

Как вызвать метод

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

Входные параметры

Общие параметры
Параметр Обязателен Тип Пример Описание
company_id Нет str 5181132708478222499 Numeric Google Maps CID/company_id returned by Google Maps places search. Example: 5181132708478222499.
country_code Нет str US Two-letter country code used for geo-localized Google results. Example: US.
language Нет str | None value Optional Google interface language code used for localized text fields. Example: en.

Путь запроса для выбранной версии

V2

Версию имеет смысл выбирать, когда вы копируете точный путь эндпоинта, пример URL и фрагмент кода. Список параметров выше при этом остается тем же самым.

GET /api/v2/google.com/maps/company-info-by-company-id

Нормализованный формат

Примеры кода

curl --request GET \
  --url "https://www.scrapestorm.net/api/v2/google.com/maps/company-info-by-company-id" \
  --header "X-API-Key: 00000000-0000-4000-8000-000000000000" \
  # Optional parameters:
  # --data-urlencode 'company_id=5181132708478222499'
  # --data-urlencode 'country_code=US'
  # --data-urlencode 'language=value'
Пример ответа

Пример ответа по версиям

Пример сокращён до ключевых полей и первых элементов коллекций, чтобы структуру ответа можно было быстро оценить. Переключатель версии меняет формат JSON.

Пример ответа

V2 — JSON

Проверенный пример

Компактный JSON-пример сформирован из последней успешной проверки версии V2.

{
  "success": true,
  "status": "ok",
  "search_context": {
    "language": "en",
    "country_code": "us",
    "company_id": "13926460886861596347"
  },
  "data": {
    "company_id": "13926460886861596347",
    "place_summary": {
      "name": "Sightglass Coffee",
      "feature_id": "0x80858082387de57f:0xc144ba641bc1c6bb",
      "place_id": "ChIJf-V9OIKAhYARu8bBG2S6RME",
      "rating": 4.4,
      "categories": [
        "Coffee shop"
      ],
      "formatted_address": "Sightglass Coffee, 270 7th St, San Francisco, CA 94103",
      "address": {
        "street_address": "270 7th St",
        "locality": "San Francisco",
        "postal_code": "94103",
        "region": "California",
        "country_code": "US"
      },
      "neighborhood": "SoMa",
      "coordinates": {
        "latitude": 37.7770356,
        "longitude": -122.40845429999999
      },
      "timezone": "America/Los_Angeles",
      "phone_number": "+1 415-463-1673",
      "website_url": "https://sightglasscoffee.com/",
      "website_host": "sightglasscoffee.com",
      "google_maps_url": "https://www.google.com/maps/preview/place/Sightglass+Coffee,+270+7th+St,+San+Francisco,+CA+94103/@37.7770356,-122.4084543,3154a,13.1y/data=!4m2!3m1!1s0x80858082387de57f:0xc144ba…",
      "opening_hours": {
        "open_now_text": "Open",
        "hours_summary": "Open · Closes 5 PM",
        "today_hours": [
          "7 AM–5 PM"
        ]
      },
      "accessibility_features": [
        {
          "code": "/geo/type/establishment_poi/has_wheelchair_accessible_entrance",
          "label": "Wheelchair accessible entrance",
          "available": true
        },
        {
          "code": "/geo/type/establishment_poi/has_wheelchair_accessible_restroom",
          "label": "Wheelchair accessible restroom",
          "available": true
        },
        {
          "_more_items": 2
        }
      ],
      "business_highlights": [
        "LGBTQ+ friendly"
      ],
      "description": "Sightglass Coffee is a women-owned, San Francisco-based coffee company devoted to sourcing, roasting, and serving the most distinctive coffees in the world. Grounded in craft an…",
      "avatar_url": "https://example.com/image.jpg"
    },
    "review_summary": {
      "rating": 4.4
    }
  }
}
Что делать дальше

Продолжить оценку API-метода

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

Открыть страницу Google API

Сравните соседние сущности, группы API-методов и связанные инструкции перед внедрением.

Открыть страницу платформы

Сравнить стоимость API-методов

Посмотрите, где этот API-метод находится в публичной таблице цен, прежде чем масштабировать использование.

Открыть тарифы

Проверить правила интеграции

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

Открыть документацию
FAQ

Вопросы, которые команды задают до внедрения

Эти ответы помогают понять, подходит ли API-метод под ваш сценарий, выбор версии и запуск.

Какие данные возвращает этот метод Google API?

Метод выполняет операцию «Сведения о компании по ID» для сущности «Карты». Точный набор полей показан в компактном примере ответа ниже.

Какую версию ответа выбрать: V1 или V2?

Для новой интеграции выбирайте V2 с нормализованной структурой. V1 нужен только для совместимости с клиентами, которые уже используют исходный формат платформы.

Что нужно для первого запроса?

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