API Google Maps

Google Maps Поиск API

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

1,40 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",
... ещё полей: 14
}
Доступность
100,00%
30d · Вызовов: 79 600
Запросы
80 016
30 дн. · по неделям, последние недель: 12
Ответ
2,8s
медиана · 30d

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

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

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

Поставщик
1KoalaОбслуживает первым1,40 USD/1 тыс. запросовflat2TigerРезерв 11,47 USD/1 тыс. запросовflat3GiraffeРезерв 2Доступность: 95,53%1792ms p500,3% вызовов1,48 USD/1 тыс. запросовflat4HeronРезерв 3Доступность: 95,08%2745ms p5019,0% вызовов1,50 USD/1 тыс. запросовflat5LynxРезерв 4Доступность: 98,98%2594ms p5076,1% вызовов1,75 USD/1 тыс. запросовflat6BadgerРезерв 5Доступность: 91,67%2425ms p500,0% вызовов2,00 USD/1 тыс. запросовflat7ChameleonРезерв 6Доступность: 99,16%2111ms p504,4% вызовов2,97 USD/1 тыс. запросовflat8MeerkatРезерв 7Доступность: 100,00%1607ms p500,0% вызовов3,25 USD/1 тыс. запросовflat9OctopusРезерв 8Доступность: 100,00%28692ms p500,2% вызовов3,66 USD/1 тыс. результатовдо 0,0769 USD / запрос
Вы платите
14,00 USD
1,40 USD/1 тыс. запросов, только за то, чем пользуетесь. Без ежемесячного тарифа.
Ваши первые запросы (71) бесплатны за счёт стартового баланса 0,10 USD.

Попробовать

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

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

В этом примере показано полей: 24 из 26. Все поля

{
  "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-11-21 · доступность и задержка измерены за 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, по одному примеру значения на поле.

each itemdata.items[]

Matching Google Maps place records. Populated whenever the provider has data for the entity.

  • addressstring

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

    Full formatted street address.

  • categoriesstring[]

    Every Google Maps category listed for the place.

  • categorystring

    Coffee shop

    Primary place category (e.g. Coffee shop).

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

    8234917364550128200

    Google customer/place id (cid).

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

    Austin

    City the place is in.

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

    US

    Two-letter country code.

  • hoursobject[]может потребовать

    Opening hours by day: each element is an object with the day name and its hours. null when the serving source does not return hours; name `hours` in `requireFields` to be served by one that does.

  • imagestring

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

    Primary place photo URL.

  • latitudenumber

    30.2687

    Latitude of the place in decimal degrees.

  • longitudenumber

    -97.7469

    Longitude of the place in decimal degrees.

  • namestring

    Mañana Coffee House

    Place name. Populated whenever the provider has data for the entity.

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

    false

    True when the place is marked permanently closed.

  • phonestring

    +1 512-555-0142

    Business phone number in E.164 format, when listed.

  • placeIdstring

    ChIJrX7cX9C1RIYR2LFEjaLyeuY

    Google Maps place id (stable identifier for the place). Populated whenever the provider has data for the entity.

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

    78701

    Postal code of the place.

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

    $$

    Relative price level indicator (e.g. $, $10-20).

  • ratingnumber

    4.6

    Average star rating out of 5.

  • reviewCountnumber

    1284

    Total number of reviews.

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

    Texas

    State or region the place is in.

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

    612 W 6th St

    Street line of the address.

  • urlstring

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

    Canonical Google Maps URL for the place. Populated whenever the provider has data for the entity.

  • websitestring

    https://mananacoffeeaustin.com

    The place's own website URL, when listed.

top level
  • foundboolean

    true

    True when the search returned at least one matching place.

  • reason"not_found"

    Present only when `found` is false, and says why there is no result. `not_found`: the source states the target does not exist, or returned nothing for it. A `found: false` answer is a successful call, not an error, and `costUsd` is what it actually cost.

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

Продаёте этот API? Полная схема, которую должен возвращать ваш эндпоинт.

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

Об API Google Maps Поиск

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

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

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

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

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

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

Отправьте запрос 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.