快速地图搜索

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": "[phone]",
      "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": "[phone]",
    "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

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