Google Maps Place Detail — API 参考文档

POST

可调用

/google/maps/detail

地图详情

按地点 ID 查询单个 Google Maps 地点，补充地点搜索，使用独立目录请求价格。

type

maps_detail

result

place

计费

3 点

按地点 ID 查询单个 Google Maps 地点，补充地点搜索，使用独立目录请求价格。

参数

字段类型出现条件说明

feature_id

必填

string

必填

使用 Maps Search 地点结果返回的 feature_id 字段，格式类似 0x...:0x...。

hl

可选

string

可选

语言代码，默认 en。

gl

可选

string

可选

国家代码，默认 us。

id

示例

string

目录示例；必填规则由接口校验。

示例: "ChIJVVVVVYxK1EARyQpK5cQqEAA"

json

{
  "id": "ChIJVVVVVYxK1EARyQpK5cQqEAA"
}

在 Playground 中调用

响应字段

字段类型出现条件说明

feature_id

必填

string

必填

地图详情请求解析出的 feature_id。

page

必填

number

必填

地图详情固定为 1。

place

可选

MapsPlace

解析到地点详情时返回。

单个地点详情对象。

MapsPlace 结果项字段

字段类型出现条件说明

position

可选

number

仅 Maps Search 返回。

地点在本地结果列表中的排名。

name

必填

string

必填

地点名称。

title

必填

string

必填

name 的别名。

feature_id

必填

string

必填

Google Maps feature id。

place_id

可选

string

Google 暴露时返回。

Google place id。

data_id

可选

string

feature_id 的别名。

Maps data id。

cid

可选

string

可从 feature_id 解析时返回。

Google CID。

kgmid

可选

string

Maps payload 中存在时返回。

知识图谱机器 ID。

google_maps_url

可选

string

Google 暴露 Maps URL 时返回。

Google Maps URL。

url

可选

string

来自 google_maps_url，缺失时回退到 website。

地点主 URL。

rating

可选

number

存在评分时返回。

Google 评分。

types

可选

string[]

存在分类时返回。

地点类型标签。

category

可选

object

解析到分类块时返回。

结构化分类数据。

address

可选

string

存在地址时返回。

格式化地址。

address_components

可选

object

存在地址组件时返回。

街道、城市、邮编、国家代码。

plus_code

可选

object

存在 plus code 时返回。

global_code 和 compound_code。

phone

可选

string

存在电话时返回。

本地电话号码。

phone_international

可选

string

存在时返回。

国际电话号码。

phone_uri

可选

string

存在时返回。

电话 URI。

website

可选

string

存在官网时返回。

商户官网。

website_domain

可选

string

存在官网域名时返回。

商户官网域名。

latitude

可选

number

存在坐标时返回。

纬度。

longitude

可选

number

存在坐标时返回。

经度。

image

可选

string

存在图片时返回。

地点主图。

thumbnail

可选

string

image 可用时作为别名返回。

主图别名。

photos

可选

MapsPhoto[]

解析到照片时返回。

照片 ID、URL、尺寸和可选坐标。

hours

可选

Record<string,string>

解析到营业时间时返回。

按星期组织的营业时间。

open_status

可选

object

存在营业状态时返回。

营业状态文本和当前营业时间。

attributes

可选

object[]

解析到属性时返回。

分组地点属性。

related_places

可选

object[]

存在相关地点时返回。

Maps payload 中的相关地点。

short_description

可选

string

存在描述块时返回。

地点短描述。

description

可选

string

存在描述块时返回。

地点长描述。

snippet

可选

string

来自 short_description 或 description。

标准化文本摘要。

timezone

可选

string

存在时返回。

地点时区。

region

可选

string

存在时返回。

区域标签。

country_code

可选

string

存在时返回。

国家代码。

language

可选

string

存在时返回。

Maps payload 中的语言代码。

代码与响应示例

bash

curl -X POST 'https://api.serpbase.dev/google/maps/detail' \
  -H "Content-Type: application/json" \
  -H 'X-API-Key: YOUR_API_KEY' \
  -d '{"id":"ChIJVVVVVYxK1EARyQpK5cQqEAA"}'

现有 Google 请求示例

bash

curl -X POST https://api.serpbase.dev/google/maps/detail \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your_api_key" \
  -d '{
    "feature_id": "0x8085809c2c6fdc63:0x4b3f2d70e4f5a123",
    "hl": "en",
    "gl": "us"
  }'

说明

地点补全、本地 CRM 数据、详情页。

使用 Maps Search 地点结果里的 feature_id 字段请求详情。格式正确但不存在的 feature_id 会返回 status 1004。