Google Maps 地点 API
按名称或搜索词在 Google Maps 上查找地点(可限定在某个地点范围内),以标准化 JSON 返回最匹配的地点及其可用的地址、联系方式、评分和坐标信息。
US$1.00/千次请求,按请求付费,无需订阅。
Blue Bottle Coffee
4.4(2,937)·Coffee shop
{"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 个字段}
价格与服务商
Google Maps 地点 API 价格:一个 API,4 个可互换的服务商
最便宜的服务商优先响应。如果它失败,下一个会在同一次调用中接手。
每次请求封顶 US$0.00991 条结果US$0.00882 条结果US$0.0099(封顶)按实际返回的内容计费。调低返回数量上限即可少付,而且无论返回多少,单次请求都不会超过封顶价。
试一试
一个请求获取 Google Maps 地点
这个示例展示了 27 个字段中的 26 个。查看全部字段
{
"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-11-14 · 可用率和延迟按 30d 统计
请求体
JSON,POST 到这个接口。
- 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,每个字段一个示例值。
The best-matching place for the query, with available address, contact, category, rating, opening-hours, and coordinate details. Up to one element (empty when nothing matched). Populated whenever the provider has data for the entity.
- addressstring
66 Mint St, San Francisco, CA 94103, USA
Full formatted street address. Populated whenever the provider has data for the entity.
- categoriesstring[]
Every Google Maps category listed for the place.
- categorystring
Coffee shop
Primary Google Maps category (e.g. Coffee shop). Populated whenever the provider has data for the entity.
- citystring可设为必填
San Francisco
- countryCodestring可设为必填
US
Two-letter country code.
- hoursobject[]
Opening hours by day: each element is an object with the day name and its hours.
- imagestring
https://lh3.googleusercontent.com/places/ANXAkqHBlueBottleMint=w500-h375-k-no
URL of the primary place photo.
- latitudenumber
37.7825
Populated whenever the provider has data for the entity.
- longitudenumber
-122.4058
Populated whenever the provider has data for the entity.
- namestring
Blue Bottle Coffee
Business or place name. Populated whenever the provider has data for the entity.
- neighborhoodstring可设为必填
SoMa
- permanentlyClosedboolean可设为必填
false
Whether the place is permanently closed.
- phonestring
+1 415-555-0118
Formatted phone number.
- placeIdstring
ChIJd7DoQL2AhYARW-mNQFPuGZo
Google Maps place id. Populated whenever the provider has data for the entity.
- plusCodestring可设为必填
QHGX+59 San Francisco, California
Google Plus Code for the location.
- postalCodestring可设为必填
94103
- priceLevelstring
$$
Price level indicator (e.g. a price range).
- ratingnumber
4.4
Average star rating.
- reviewsCountinteger
2937
Total number of reviews.
- statestring可设为必填
California
State or region name.
- streetstring可设为必填
66 Mint St
Street portion of the address.
- urlstring
https://www.google.com/maps/place/?q=place_id:ChIJd7DoQL2AhYARW-mNQFPuGZo
Google Maps URL for the place. Populated whenever the provider has data for the entity.
- websitestring
https://bluebottlecoffee.com
Business website URL.
- foundboolean
true
- 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.
常见问题
关于 Google Maps 地点 API
AnyAPI 的 Google Maps 地点 API 只需一次 POST 请求 /v1/run/maps.place,就以统一格式的 JSON 返回 Google Maps 数据。按名称或搜索词在 Google Maps 上查找地点(可限定在某个地点范围内),以标准化 JSON 返回最匹配的地点及其可用的地址、联系方式、评分和坐标信息。AnyAPI 会在 4 个数据源之间路由每个请求,某个数据源失败时自动切换。费用:每千次请求 US$1 起,以美元计价,无需订阅,也没有每月最低消费。过去 30 天,通过 AnyAPI 发起的 Google Maps 地点 API 调用中有 100.0% 成功,响应时间中位数为 2.5 秒,共测量 150,371 次调用。