API Google Maps

Google Maps Поиск API

Ищет на Google Maps места по запросу и местоположению: до 20 нормализованных записей о местах с рейтингами, адресами и основными контактами за запрос.

1,75 USD/1 тыс. запросов, оплата за запрос, без подписки.

coffee shop - Google Maps
google.com/maps/search/coffee%20shop
coffee shop in Austin, TX
ResultsShare

Mañana Coffee House

4.6(1,284)

Coffee shop · 612 W 6th St, Austin, TX 78701, USA

Mañana Coffee House
Google Maps
Что вернул APIitems[0]
{
"placeId": "ChIJrX7cX9C1RIYR2LFEjaLyeuY",
"cid": "8234917364550128200",
"name": "Mañana Coffee House",
"url": "https://www.google.com/maps/place/?q=place_id:ChIJrX7cX9C1RIYR2LFEjaLyeuY",
"category": "Coffee shop",
"categories": [...],
"address": "612 W 6th St, Austin, TX 78701, USA",
"street": "612 W 6th St",
+13 ещё
}
Доступность
99,99%
30d · Вызовов: 126 578
Запросы
126 578
30 дн. · по неделям, последние недель: 12
Ответ
2,8s
медиана · 30d

Цены и поставщики

Цена API Google Maps Поиск: один API, поставщиков 4, и любой может заменить другого

Первым обслуживает самый дешёвый поставщик. Если он не отвечает, его заменяет следующий в том же вызове.

Вы платите
17,50 USD
1,75 USD/1 тыс. запросов, только за то, чем пользуетесь. Без ежемесячного тарифа.
Ваши первые запросы (57) бесплатны за счёт стартового баланса 0,10 USD.

Попробовать

Получите Google Maps Поиск одним запросом

requireFieldsarray
Необязательно; если не указывать, маршрутизация не меняется и обслуживает самый дешёвый источник. Назовите выходные поля, которые этот запрос должен уметь вернуть, например `cid` или `street`, и его обслужит только источник, который возвращает каждое из них. Поля, которые вы не назвали, по-прежнему возвращаются, когда они есть у обслуживающего источника. Это может поднять вашу цену: если самый дешёвый источник не может вернуть названное поле, обслуживает более дорогой, и вам называют и списывают его цену. Названное поле всё равно может отсутствовать в месте, где его действительно нет. Указание сочетания полей, которые вместе не возвращает ни один источник, отклоняется как неверный ввод, без списания.
Открыть в
Пример ответа
Бесплатные запуски возвращают только первые результаты: 3. Пополните ключ, чтобы получить полный ответ.
{
  "found": true,
  "data": {
    "items": [
      {
        "placeId": "ChIJrX7cX9C1RIYR2LFEjaLyeuY",
        "cid": "8234917364550128200",
        "name": "Mañana Coffee House",
        "url": "https://www.google.com/maps/place/?q=place_id:ChIJrX7cX9C1RIYR2LFEjaLyeuY",
        "category": "Coffee shop",
        "categories": [
          "Coffee shop",
          "Breakfast restaurant",
          "Bakery"
        ],
        "address": "612 W 6th St, Austin, TX 78701, USA",
        "street": "612 W 6th St",
        "city": "Austin",
        "state": "Texas",
        "postalCode": "78701",
        "countryCode": "US",
        "latitude": 30.2687,
        "longitude": -97.7469,
        "phone": "+1 512-555-0142",
        "website": "https://mananacoffeeaustin.com",
        "rating": 4.6,
        "reviewCount": 1284,
        "priceLevel": "$$",
        "permanentlyClosed": false,
        "image": "https://lh3.googleusercontent.com/places/ANXAkqHmananaCoffee6thSt=w400-h300-k-no"
      },
      {
        "placeId": "ChIJq6qq6X61RIYRXVfIhGlJ7YQ",
        "cid": "5127740981263455000",
        "name": "Radio Coffee & Beer",
        "url": "https://www.google.com/maps/place/?q=place_id:ChIJq6qq6X61RIYRXVfIhGlJ7YQ",
        "category": "Coffee shop",
        "categories": [
          "Coffee shop",
          "Bar"
        ],
        "address": "4204 Menchaca Rd, Austin, TX 78704, USA",
        "street": "4204 Menchaca Rd",
        "city": "Austin",
        "state": "Texas",
        "postalCode": "78704",
        "countryCode": "US",
        "latitude": 30.2277,
        "longitude": -97.7808,
        "phone": "+1 512-555-0187",
        "website": "https://radiocoffeeandbeer.com",
        "rating": 4.7,
        "reviewCount": 3021,
        "priceLevel": "$$",
        "permanentlyClosed": false,
        "image": "https://lh3.googleusercontent.com/places/ANXAkqHRadioCoffeeBeerPatio=w400-h300-k-no"
      },
      {
        "placeId": "ChIJgUbEo8cKRIYRZ4h8dQ3jL2s",
        "name": "Summer Moon Coffee",
        "url": "https://www.google.com/maps/place/?q=place_id:ChIJgUbEo8cKRIYRZ4h8dQ3jL2s",
        "category": "Coffee shop",
        "categories": [
          "Coffee shop"
        ],
        "address": "1900 Aldrich St Ste 100, Austin, TX 78723, USA",
        "street": "1900 Aldrich St Ste 100",
        "city": "Austin",
        "state": "Texas",
        "postalCode": "78723",
        "countryCode": "US",
        "latitude": 30.296,
        "longitude": -97.7028,
        "website": "https://summermooncoffee.com",
        "rating": 4.5,
        "reviewCount": 642,
        "priceLevel": "$",
        "permanentlyClosed": false,
        "image": "https://lh3.googleusercontent.com/places/ANXAkqHSummerMoonAldrich=w400-h300-k-no"
      }
    ]
  }
}

Полный справочник по параметрам и ответу: каждое поле, тип и пример для этого эндпоинта.

Справочник

Один запрос, один формат ответа.

Каждое поле, которое вы отправляете, и каждое поле, которое получаете, с реальным примером.

Проверено 2026-10-07 · доступность и задержка измерены за 30d

Тело запроса

JSON, отправляется на этот эндпоинт.

  • locationstring

    Austin, TX

    Местоположение для поиска в свободной форме, лучше город и страна (например, Austin, USA).

  • querystring

    coffee shop

    То, что вы ввели бы в строку поиска Google Maps (например, coffee shop).

  • categoryFilterWordsarray

    Необязательный список названий категорий мест Google Maps, которые нужно оставить; результаты ограничиваются местами, категория которых совпадает с одной из них. Используйте названия категорий в нижнем регистре, как они показаны на Google Maps (например, ["coffee shop", "restaurant"]). Не указывайте, чтобы включить все категории и остаться на самой низкой цене; фильтр по категории направляет запрос к более дорогому источнику.

  • languagestring

    Двухбуквенный код языка для результатов (например, en).

  • limitinteger

    3

    Максимальное число возвращаемых результатов (1-20, по умолчанию 20). Цена зависит от выбранного поставщика и может быть фиксированной за запрос.

  • placeMinimumStarsenum

    Возвращать только места со средним рейтингом не ниже заданного: two (2+), twoAndHalf (2.5+), three (3+), threeAndHalf (3.5+), four (4+) или fourAndHalf (4.5+). Места без отзывов исключаются. Не указывайте это поле, чтобы остаться на самой низкой цене; нижняя граница рейтинга направляет запрос к более дорогому источнику.

  • requireFieldsarray

    Необязательно; если не указывать, маршрутизация не меняется и обслуживает самый дешёвый источник. Назовите выходные поля, которые этот запрос должен уметь вернуть, например `cid` или `street`, и его обслужит только источник, который возвращает каждое из них. Поля, которые вы не назвали, по-прежнему возвращаются, когда они есть у обслуживающего источника. Это может поднять вашу цену: если самый дешёвый источник не может вернуть названное поле, обслуживает более дорогой, и вам называют и списывают его цену. Названное поле всё равно может отсутствовать в месте, где его действительно нет. Указание сочетания полей, которые вместе не возвращает ни один источник, отклоняется как неверный ввод, без списания.

  • websiteenum

    Фильтр мест по тому, указан ли у них сайт: allPlaces (по умолчанию), withWebsite (только места с сайтом) или withoutWebsite (только места без сайта). Не указывайте это поле или отправьте allPlaces, чтобы остаться на самой низкой цене; withWebsite и withoutWebsite направляют запрос к более дорогому источнику.

Вы отправляете. Небольшое тело JSON. Показанные значения это примеры, замените их своими.

Ответ

JSON, по одному примеру значения на поле.

  • foundboolean

    true

each itemdata.items[]
  • placeIdstring

    ChIJrX7cX9C1RIYR2LFEjaLyeuY

  • cidstringможет потребовать

    8234917364550128200

  • namestring

    Mañana Coffee House

  • urlstring

    https://www.google.com/maps/place/?q=place_id:ChIJrX7cX9C1RIYR2LFEjaLyeuY

  • categorystring

    Coffee shop

  • categories[]string

    Coffee shop

  • addressstring

    612 W 6th St, Austin, TX 78701, USA

  • streetstringможет потребовать

    612 W 6th St

  • citystringможет потребовать

    Austin

  • statestringможет потребовать

    Texas

  • postalCodestringможет потребовать

    78701

  • countryCodestringможет потребовать

    US

  • latitudenumber

    30.2687

  • longitudenumber

    -97.7469

  • phonestringможет потребовать

    +1 512-555-0142

  • websitestring

    https://mananacoffeeaustin.com

  • ratingnumber

    4.6

  • reviewCountnumber

    1284

  • priceLevelstringможет потребовать

    $$

  • permanentlyClosedbooleanможет потребовать

    false

  • imagestring

    https://lh3.googleusercontent.com/places/ANXAkqHmananaCoffee6thSt=w400-h300-k-no

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

Вопросы и ответы

Об API Google Maps Поиск

AnyAPI Google Maps Поиск API возвращает данные Google Maps в виде нормализованного JSON одним вызовом POST к /v1/run/maps.search. Ищет на Google Maps места по запросу и местоположению: до 20 нормализованных записей о местах с рейтингами, адресами и основными контактами за запрос. AnyAPI направляет каждый запрос по источникам (их 4) и автоматически переключается, если один из них отказывает. Это стоит от 1,75 USD за 1000 запросов, в долларах США, без подписки и без ежемесячного минимума. За последние 30 дней 100,0% вызовов Google Maps Поиск через AnyAPI завершились успешно, медианное время ответа 2,8 с, измерено вызовов: 126 578.

Это стоит от 1,75 USD за 1000 запросов, в долларах США, без подписки и без ежемесячного минимума. Вы пополняете один кошелёк в долларах США, и каждый вызов списывает с него. По некоторым неудавшимся запросам, оплаченным из кошелька, возникают расходы на обработку; мы передаём их по себестоимости, без наценки, а сумма списания указана в ответе с ошибкой.

Ищет на Google Maps места по запросу и местоположению: до 20 нормализованных записей о местах с рейтингами, адресами и основными контактами за запрос. Ответ это нормализованный JSON с тем же конвертом, что возвращает каждый эндпоинт AnyAPI, поэтому разбор второго эндпоинта это смена URL и ничего больше.

За последние 30 дней 100,0% вызовов Google Maps Поиск через AnyAPI завершились успешно, медианное время ответа 2,8 с, измерено вызовов: 126 578. Это собственные измерения AnyAPI по трафику через шлюз, пересчитываемые непрерывно, а не опубликованный целевой уровень обслуживания.

Да. Новый аккаунт AnyAPI стартует с бесплатным балансом 0,10 USD, карта не нужна. Этого хватает на 57 вызовов Google Maps Поиск по 0,00175 USD за каждый.

AnyAPI в том же запросе обращается к следующему из источников (их 4), начиная с самого дешёвого, поэтому отказ одного источника не ломает ваш вызов.

Отправьте запрос POST на https://api.getanyapi.com/v1/run/maps.search с вашим ключом AnyAPI в заголовке "Authorization: Bearer" и входными данными в теле JSON. Один и тот же ключ и один и тот же кошелёк работают на каждом эндпоинте AnyAPI.

Нет. Вы пополняете один предоплаченный баланс AnyAPI в долларах США, и каждый запрос списывает с него. Ежемесячного тарифа и минимума нет, а один и тот же баланс оплачивает каждый эндпоинт AnyAPI.

Да. Установите @getanyapi/sdk из npm для TypeScript или getanyapi из pip для Python. Оба вызывают любой эндпоинт AnyAPI с одним и тем же ключом, а ещё подойдёт любой HTTP-клиент.

Да. Агент может подключиться к MCP-серверу AnyAPI по адресу https://api.getanyapi.com/mcp или создать собственный бесплатный пробный ключ одним POST без аутентификации на https://api.getanyapi.com/agent/signup и вызывать этот эндпоинт по HTTP.