API Google Maps

Google Maps Место API

Ищет место на Google Maps по названию или поисковому запросу (при желании в пределах местоположения) и возвращает лучшее совпадение с доступными данными об адресе, контактах, рейтинге и координатах в виде нормализованного JSON.

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

Blue Bottle Coffee - Google Maps
google.com/maps/place/?q=place_id:ChIJd7DoQL2AhYARW-mNQFPuGZo
DirectionsSaveNearbySend to phoneShare

Blue Bottle Coffee

4.4(2,937)·Coffee shop

66 Mint St, San Francisco, CA 94103, USA
Open · Monday 6:30 AM-6:00 PM
+1 415-555-0118
bluebottlecoffee.com
OverviewReviewsAbout
Что вернул APIitems[0]
{
"name": "Blue Bottle Coffee",
"url": "https://www.google.com/maps/place/?q=place_id:ChIJd7DoQL2AhYARW-mNQFPuGZo",
"placeId": "ChIJd7DoQL2AhYARW-mNQFPuGZo",
"address": "66 Mint St, San Francisco, CA 94103, USA",
"street": "66 Mint St",
"city": "San Francisco",
"state": "California",
"postalCode": "94103",
+15 ещё
}
Доступность
100,00%
30d · Вызовов: 55 527
Запросы
55 528
30 дн. · по неделям, последние недель: 12
Ответ
3,0s
медиана · 30d

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

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

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

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

Попробовать

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

requireFieldsarray
Optional; omit it and routing is unchanged, with the cheapest source serving. Name the output fields this request must be able to return, for example `plusCode` or `postalCode`, and it is served only by a source that returns every one of them. Fields you do not name are still returned whenever the serving source has them. This can raise your price: when the cheapest source cannot return a named field, a dearer source serves, and you are quoted and charged its price. A named field can still be absent on a place that genuinely lacks it. Naming a combination that no single source returns together is refused as invalid input, with no charge.
Открыть в
Пример ответа
Бесплатные запуски возвращают только первые результаты: 3. Пополните ключ, чтобы получить полный ответ.
{
  "found": true,
  "data": {
    "items": [
      {
        "name": "Blue Bottle Coffee",
        "url": "https://www.google.com/maps/place/?q=place_id:ChIJd7DoQL2AhYARW-mNQFPuGZo",
        "placeId": "ChIJd7DoQL2AhYARW-mNQFPuGZo",
        "address": "66 Mint St, San Francisco, CA 94103, USA",
        "street": "66 Mint St",
        "city": "San Francisco",
        "state": "California",
        "postalCode": "94103",
        "countryCode": "US",
        "neighborhood": "SoMa",
        "phone": "+1 415-555-0118",
        "website": "https://bluebottlecoffee.com",
        "category": "Coffee shop",
        "categories": [
          "Coffee shop",
          "Cafe",
          "Espresso bar"
        ],
        "rating": 4.4,
        "reviewsCount": 2937,
        "latitude": 37.7825,
        "longitude": -122.4058,
        "image": "https://lh3.googleusercontent.com/places/ANXAkqHBlueBottleMint=w500-h375-k-no",
        "priceLevel": "$$",
        "plusCode": "QHGX+59 San Francisco, California",
        "permanentlyClosed": false,
        "hours": [
          {
            "day": "Monday",
            "hours": "6:30 AM-6:00 PM"
          },
          {
            "day": "Tuesday",
            "hours": "6:30 AM-6:00 PM"
          },
          {
            "day": "Wednesday",
            "hours": "6:30 AM-6:00 PM"
          },
          {
            "day": "Thursday",
            "hours": "6:30 AM-6:00 PM"
          },
          {
            "day": "Friday",
            "hours": "6:30 AM-6:00 PM"
          },
          {
            "day": "Saturday",
            "hours": "7:00 AM-6:00 PM"
          },
          {
            "day": "Sunday",
            "hours": "7:00 AM-5:00 PM"
          }
        ]
      }
    ]
  }
}

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

Справочник

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

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

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

Тело запроса

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

  • querystring

    Blue Bottle Coffee

    Название компании или поисковый текст, как вы ввели бы его в строку поиска Google Maps (например, Blue Bottle Coffee).

  • categoryFilterWordsarray

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

  • languagestring

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

  • locationstring

    San Francisco, CA

    Необязательное местоположение в свободной форме, ограничивающее поиск, лучше город плюс штат или страна (например, San Francisco, CA). Сужает запрос до лучшего совпадения в этой области.

  • placeMinimumStarsenum

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

  • requireFieldsarray

    Optional; omit it and routing is unchanged, with the cheapest source serving. Name the output fields this request must be able to return, for example `plusCode` or `postalCode`, and it is served only by a source that returns every one of them. Fields you do not name are still returned whenever the serving source has them. This can raise your price: when the cheapest source cannot return a named field, a dearer source serves, and you are quoted and charged its price. A named field can still be absent on a place that genuinely lacks it. Naming a combination that no single source returns together is refused as invalid input, with no charge.

  • websiteenum

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

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

Ответ

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

  • foundboolean

    true

each itemdata.items[]
  • namestring

    Blue Bottle Coffee

  • urlstring

    https://www.google.com/maps/place/?q=place_id:ChIJd7DoQL2AhYARW-mNQFPuGZo

  • placeIdstring

    ChIJd7DoQL2AhYARW-mNQFPuGZo

  • addressstring

    66 Mint St, San Francisco, CA 94103, USA

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

    66 Mint St

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

    San Francisco

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

    California

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

    94103

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

    US

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

    SoMa

  • phonestring

    +1 415-555-0118

  • websitestring

    https://bluebottlecoffee.com

  • categorystring

    Coffee shop

  • categories[]string

    Coffee shop

  • ratingnumber

    4.4

  • reviewsCountnumber

    2937

  • latitudenumber

    37.7825

  • longitudenumber

    -122.4058

  • imagestring

    https://lh3.googleusercontent.com/places/ANXAkqHBlueBottleMint=w500-h375-k-no

  • priceLevelstring

    $$

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

    QHGX+59 San Francisco, California

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

    false

each hourdata.items[].hours[]
  • daystring

    Monday

  • hoursstring

    6:30 AM-6:00 PM

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

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

Об API Google Maps Место

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

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

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

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

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

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

Отправьте запрос POST на https://api.getanyapi.com/v1/run/maps.place с вашим ключом 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.