Google Maps Search — API 参考文档
/google/maps/search地图搜索
按查询和位置搜索 Google Maps 地点。已识别地点详情使用独立接口。
按查询和位置搜索 Google Maps 地点。已识别地点详情使用独立接口。
qstring必填
搜索查询字符串。
hlstring可选
语言代码，默认 en。
glstring可选
国家代码，默认 us。
pagenumber可选
从 1 开始的页码，默认 1。
latnumber可选
地图中心纬度，必须和 lng 一起传。
lngnumber可选
地图中心经度，必须和 lat 一起传。
zoomnumber可选
地图缩放级别 1 到 21；传坐标时默认 14。
locationobject目录示例；必填规则由接口校验。
示例: {"location_query":"Seattle, WA"}
querystring目录示例；必填规则由接口校验。
示例: "coffee"
{
"location": {
"location_query": "Seattle, WA"
},
"query": "coffee"
}querystring必填
请求中的标准化 query。
pagenumber必填
当前页码，从 1 开始。
placesMapsPlace[]解析到本地地点时返回。
本地地点结果。
positionnumber仅 Maps Search 返回。
地点在本地结果列表中的排名。
namestring必填
地点名称。
titlestring必填
name 的别名。
feature_idstring必填
Google Maps feature id。
place_idstringGoogle 暴露时返回。
Google place id。
data_idstringfeature_id 的别名。
Maps data id。
cidstring可从 feature_id 解析时返回。
Google CID。
kgmidstringMaps payload 中存在时返回。
知识图谱机器 ID。
google_maps_urlstringGoogle 暴露 Maps URL 时返回。
Google Maps URL。
urlstring来自 google_maps_url，缺失时回退到 website。
地点主 URL。
ratingnumber存在评分时返回。
Google 评分。
typesstring[]存在分类时返回。
地点类型标签。
categoryobject解析到分类块时返回。
结构化分类数据。
addressstring存在地址时返回。
格式化地址。
address_componentsobject存在地址组件时返回。
街道、城市、邮编、国家代码。
plus_codeobject存在 plus code 时返回。
global_code 和 compound_code。
phonestring存在电话时返回。
本地电话号码。
phone_internationalstring存在时返回。
国际电话号码。
phone_uristring存在时返回。
电话 URI。
websitestring存在官网时返回。
商户官网。
website_domainstring存在官网域名时返回。
商户官网域名。
latitudenumber存在坐标时返回。
纬度。
longitudenumber存在坐标时返回。
经度。
imagestring存在图片时返回。
地点主图。
thumbnailstringimage 可用时作为别名返回。
主图别名。
photosMapsPhoto[]解析到照片时返回。
照片 ID、URL、尺寸和可选坐标。
hoursRecord<string,string>解析到营业时间时返回。
按星期组织的营业时间。
open_statusobject存在营业状态时返回。
营业状态文本和当前营业时间。
attributesobject[]解析到属性时返回。
分组地点属性。
related_placesobject[]存在相关地点时返回。
Maps payload 中的相关地点。
short_descriptionstring存在描述块时返回。
地点短描述。
descriptionstring存在描述块时返回。
地点长描述。
snippetstring来自 short_description 或 description。
标准化文本摘要。
timezonestring存在时返回。
地点时区。
regionstring存在时返回。
区域标签。
country_codestring存在时返回。
国家代码。
languagestring存在时返回。
Maps payload 中的语言代码。
curl -X POST 'https://api.serpbase.dev/google/maps/search' \
-H "Content-Type: application/json" \
-H 'X-API-Key: YOUR_API_KEY' \
-d '{"location":{"location_query":"Seattle, WA"},"query":"coffee"}'现有 Google 请求示例
curl -X POST https://api.serpbase.dev/google/maps/search \
-H "Content-Type: application/json" \
-H "X-API-Key: your_api_key" \
-d '{
"q": "coffee",
"hl": "en",
"gl": "us",
"page": 1,
"lat": 37.7749,
"lng": -122.4194,
"zoom": 14
}'本地发现、门店查询、地理定向审计。
lat 和 lng 必须一起传。zoom 只有传坐标时才有效，默认 14。