跳转到主要内容

Documentation Index

Fetch the complete documentation index at: https://docs.brightdata.com/llms.txt

Use this file to discover all available pages before exploring further.

Bright Data 为谷歌地图提供快速 SERP 服务，仅向特定企业客户提供。该服务以紧凑的 JSON 响应，为需要本地商业列表和地点数据的实时应用提供支持。如需获取访问权限，请联系您的 Bright Data 账户经理。

​
Google Maps 端点

Google Maps Fast SERP 根据您访问的 URL 支持两种响应类型：
  • 地图搜索结果 — 与搜索查询匹配的地点列表，返回 organic 数组
  • 地点详情页面 — 单个地点记录，返回 place 对象
两个端点都需要 x-unblock-data-format: parsed_light 请求头和 brd_json=1 URL 参数。省略任何一个都会导致意外的响应格式。

​
Fast Maps 搜索请求

Google Maps Fast SERP 最适合使用原生代理接口。如果您的架构需要 REST API 接口，我们可以提供一个。

​
地图搜索结果

curl -v --proxy fserp.brd.superproxy.io:33335 \
  --proxy-user username:password \
  -k \
  -H 'x-unblock-data-format: parsed_light' \
  "https://www.google.com/maps/search/coffee+shops+new+york/?hl=en&gl=us&brd_json=1"

​
地点详情页面

curl -v --proxy fserp.brd.superproxy.io:33335 \
  --proxy-user username:password \
  -k \
  -H 'x-unblock-data-format: parsed_light' \
  "https://www.google.com/maps/place/?q=place_id:ChIJN1t_tDeuEmsRUsoyG83frY4&hl=en&gl=us&brd_json=1"

​
响应格式

响应是两种形状之一，取决于目标 URL：搜索结果页面返回 organic 数组；地点详情页面返回 place 对象。两者都使用相同的 OrganicMapsItem 结构。

​
organic 数组 / place 对象

organic 中的项目和 place 对象都共享以下字段：
字段类型必需描述
global_rank整数是结果在页面上的排名位置
title字符串否地点名称
address字符串否地点的完整地址
phone字符串否地点的电话号码
link字符串否地点网站的 URL
map_link字符串否地点在 Google Maps 上的 URL
map_id字符串否Google Maps 地点标识符
map_id_encoded字符串否Google Maps 地点标识符的编码版本
description字符串否地点的简短描述
price字符串否价格范围指标，例如 "$$"
rating数字否平均客户评分
reviews_cnt数字否客户评论总数
latitude数字否地点的纬度坐标
longitude数字否地点的经度坐标
image字符串否主要图像 URL
original_image字符串否原始全分辨率图像 URL
thumbnail字符串否缩略图 URL
open_hours对象否按日期划分的营业时间，例如 "Monday": "9am–5pm"
category数组否地点类别列表（见下文）
images数组否地点图像列表（见下文）
menu_images数组否菜单图像列表（见下文）
tags数组否地点属性标签列表（见下文）
reviews数组否客户评论列表（见下文）

​
category 项目

字段类型必需描述
id字符串是类别标识符
title字符串是完整类别名称
title_short字符串否缩短的类别名称

​
images 和 menu_images 项目

字段类型必需描述
image字符串是图像 URL
image_width整数否显示的图像宽度（像素）
image_height整数否显示的图像高度（像素）
original_width整数否原始图像宽度（像素）
original_height整数否原始图像高度（像素）

​
tags 项目

字段类型必需描述
group_id字符串是标签组的标识符
group_title字符串是标签组的显示名称
key_id字符串是标签键的标识符
key_title字符串是标签键的显示名称
value数字否与标签关联的数值
value_title字符串否标签值的显示标签
value_title_short字符串否标签值的缩短显示标签

​
reviews 项目

字段类型描述
author字符串评论者的名称
avatar字符串评论者的个人资料图像 URL
author_reviews_cnt数字此作者撰写的评论总数
author_photos_cnt数字此作者上传的照片总数
rating数字此评论中给出的评分
text字符串评论文本内容
timestamp_added字符串评论发布的日期/时间
timestamp_edited字符串评论最后编辑的日期/时间
link字符串评论的 URL
source字符串评论的平台来源
source_logo字符串来源平台的徽标 URL
images字符串数组附加到评论的图像 URL 列表
response_text字符串所有者对评论的回复
response_timestamp_added字符串所有者回复发布的日期/时间
response_timestamp_edited字符串所有者回复最后编辑的日期/时间

​
示例响应

​
地图搜索结果

{
  "organic": [
    {
      "global_rank": 1,
      "title": "Example Coffee Co.",
      "address": "123 Main St, New York, NY 10001",
      "phone": "+1 212-555-0100",
      "link": "https://www.example-coffee.com",
      "map_link": "https://www.google.com/maps/place/example-coffee",
      "map_id": "ChIJexample1234",
      "description": "Specialty coffee shop serving single-origin espresso and pour-overs.",
      "price": "$$",
      "rating": 4.7,
      "reviews_cnt": 1280,
      "latitude": 40.7128,
      "longitude": -74.0060,
      "thumbnail": "https://www.example-coffee.com/images/thumb.jpg",
      "open_hours": {
        "Monday": "7am–7pm",
        "Tuesday": "7am–7pm",
        "Wednesday": "7am–7pm",
        "Thursday": "7am–7pm",
        "Friday": "7am–8pm",
        "Saturday": "8am–8pm",
        "Sunday": "9am–6pm"
      },
      "category": [
        { "id": "coffee_shop", "title": "Coffee Shop", "title_short": "Coffee" }
      ],
      "tags": [
        {
          "group_id": "service_options",
          "group_title": "Service options",
          "key_id": "dine_in",
          "key_title": "Dine-in",
          "value": 1,
          "value_title": "Available",
          "value_title_short": "Yes"
        }
      ],
      "reviews": [
        {
          "author": "Jane D.",
          "avatar": "https://example.com/avatars/jane.jpg",
          "author_reviews_cnt": 42,
          "author_photos_cnt": 15,
          "rating": 5,
          "text": "Best espresso in the city, hands down.",
          "timestamp_added": "2025-03-10T09:00:00Z",
          "source": "Google",
          "source_logo": "https://www.google.com/images/google-logo.png",
          "response_text": "Thank you so much, Jane! See you soon.",
          "response_timestamp_added": "2025-03-11T10:00:00Z"
        }
      ]
    }
  ]
}

​
地点详情页面

{
  "place": {
    "global_rank": 1,
    "title": "Example Coffee Co.",
    "address": "123 Main St, New York, NY 10001",
    "phone": "+1 212-555-0100",
    "link": "https://www.example-coffee.com",
    "map_link": "https://www.google.com/maps/place/example-coffee",
    "map_id": "ChIJexample1234",
    "description": "Specialty coffee shop serving single-origin espresso and pour-overs.",
    "price": "$$",
    "rating": 4.7,
    "reviews_cnt": 1280,
    "latitude": 40.7128,
    "longitude": -74.0060,
    "thumbnail": "https://www.example-coffee.com/images/thumb.jpg",
    "images": [
      {
        "image": "https://www.example-coffee.com/images/interior.jpg",
        "image_width": 800,
        "image_height": 600,
        "original_width": 1600,
        "original_height": 1200
      }
    ],
    "open_hours": {
      "Monday": "7am–7pm",
      "Friday": "7am–8pm",
      "Saturday": "8am–8pm",
      "Sunday": "9am–6pm"
    },
    "category": [
      { "id": "coffee_shop", "title": "Coffee Shop", "title_short": "Coffee" }
    ]
  }
}
响应模式：https://api.brightdata.com/data_schemas/fast_serp/google_search_maps.schema.json

​
支持的参数

​
gl

两字母国家代码，用于定义搜索的国家

​
hl

两字母语言代码，用于定义页面语言