Google Maps Поиск API
Ищет на Google Maps места по запросу и местоположению: до 20 нормализованных записей о местах с рейтингами, адресами и основными контактами за запрос.
1,40 USD/1 тыс. запросов, оплата за запрос, без подписки.
Mañana Coffee House
4.6(1,284)
Coffee shop · 612 W 6th St, Austin, TX 78701, USA
{"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}
Цены и поставщики
Цена API Google Maps Поиск: один API, поставщиков 9, и любой может заменить другого
Первым обслуживает самый дешёвый поставщик. Если он не отвечает, его заменяет следующий в том же вызове.
не больше 0,0769 USD за запрос1 результат0,0039 USDРезультатов: 110,0423 USDРезультатов: 21Лимит 0,0769 USDВы платите за то, что вернулось. Снизьте лимит, чтобы платить меньше: ни один запрос не обойдётся дороже лимита, сколько бы ни вернулось.
Попробовать
Получите Google Maps Поиск одним запросом
В этом примере показано полей: 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, по одному примеру значения на поле.
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.
- 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.