面向开发者的 G Maps Crawl

Google Maps 数据。
内建于您的工作流。

搜索商户、读取公开评价、浏览地点照片和视频。通过同步 REST API 构建,或通过 MCP 让您的 AI 助手直接接入。

结构化 JSON

结果在同一响应中返回

REST + MCP

在您的应用或 AI 客户端中使用

一套 API 额度

API 与 MCP 请求共享

选择您的数据

为研究的每一步准备一个 API

先进行商户搜索,然后使用该地点的 feature ID 请求评价或相册内容。每个 API 都有独立的示例和字段参考。

您的第一个 API 请求

从一个请求到结构化数据

在 Authorization 头中使用 API 密钥。浏览下面的请求格式,然后按照快速上手指南发起第一次调用。

请求示例

完整的接口约定请参见 API 文档。

curl https://gmapscrawl.com/api/v1/search \
  -H "Authorization: Bearer $GMSCRAPER_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: seattle-coffee-search-001" \
  -d '{"q":"coffee shops in Seattle","page":1,"extra":false}'

示例为空响应。正式搜索会返回可用的商户。请将 API 密钥保存在服务器端;为新任务使用新的幂等键,并在原请求不变的重试中保留同一幂等键。

响应

示例 JSON
{
  "data": {
    "total": 0,
    "params": {
      "q": "coffee shops in Seattle",
      "page": 1,
      "hl": "en",
      "extra": false
    },
    "businesses": []
  },
  "request_id": "req_example",
  "schema_version": "2026-09-22"
}

API 在同一响应中返回 JSON。超时后,请使用相同的 Idempotency-Key 以不变的请求体重试。测试凭据返回模拟数据,不消耗您的正式额度。

基于标准 HTTP 构建

一次小型集成,一条实用的数据工作流。

01

创建 API 密钥

在您的 API 工作区创建凭据,并将其保存在服务器或客户端的私密配置中。REST 和 MCP 共享同一 API 额度。

打开 API 密钥
02

选择一个 API

按关键词和地点搜索。获取评价和照片时,提供您已有的 Maps feature ID,或从搜索结果中读取 place.dataId。

按快速上手操作
03

读取 JSON 响应

在您的应用中处理返回的页面。遵循端点的分页规则,检查缺失字段,并为重试保留请求的幂等键。

了解分页

构建有用的东西

将 Maps 数据带入您的应用

将返回的记录用作您自己的研究、报告和内部工作流的输入。

01

本地商户研究

搜索某个类别和地点,然后在您的应用中整理可用的商户名称、地址、网站、电话号码和评分。

02

评价分析

查询某个地点的公开评价以研究客户反馈。选择一致的排序方式,并按可用页数开展分析。

03

地点相册研究

获取某个地点可用的照片和视频链接。将来源相册链接与记录一起保存,以便您的团队查看原始上下文。

您的智能体,已连接

在您的 AI 客户端中使用同样的数据。

连接 MCP 服务器以获得可发现的工具,或安装 Agent Skill 以获得可复用的工作流说明和 REST 备用方案。

为您的已连接智能体准备的示例任务

“搜索西雅图的一页咖啡店。返回可用的名称、网站和评分,并指出缺失的数据。”

请求消耗您的 API 额度。使用测试凭据时,结果为模拟数据。

规划您的集成

在扩展规模前了解用量

每个成功的正式页面(包括空页面)消耗一次 API 请求。REST 与 MCP 共享您的 API 套餐;在线抓取工具和浏览器扩展有独立的额度。

让请求可预测

先从一页开始,检查返回的字段,并为端点设置合适的客户端超时。重试时,使用相同的 Idempotency-Key 和不变的请求体。

套餐限额、速率限制、来源可用性和信息补全都会影响正式请求。测试凭据返回模拟数据,不消耗您的正式额度。

请查看各端点页面了解请求限制和结果字段。价格页面列出了当前包含的请求数和付费超额费率。

常见问题

有哪些可用的 Google Maps API?

G Maps Crawl 提供商户搜索、公开地点评价和地点照片/相册 API。Search 返回商户记录;Reviews 和 Photos 使用 Maps feature ID 返回特定地点的一页数据。

我可以使用 Python 或 JavaScript 吗?

可以。这些 API 使用 HTTP 请求和 JSON,因此您可以用 Python、JavaScript、cURL 或其他 HTTP 客户端调用。每个 API 页面都包含请求示例和响应示例。

我需要轮询任务结果吗?

公开的 Search、Reviews 和 Photos API 在同一响应中返回 JSON,不需要任务轮询或 webhook 配置。请遵循端点的超时和重试指引。

API、MCP 和 Agent Skill 如何协同工作?

REST 让您的应用直接调用端点。MCP 让兼容的 AI 客户端可以使用这些工具。Agent Skill 提供工作流说明和辅助脚本。REST 和 MCP 请求都需要 API 凭据并消耗您的 API 额度。

我在哪里获取用于评价和照片的 feature ID?

使用您已有的 Maps feature ID,或从 Search API 的 data.businesses 数组中复制匹配记录的 place.dataId,并将该值作为 fid 传给 Reviews 或 Photos API。

是否保证每个字段都可用?

不是。返回的字段取决于来源和所选操作。在使用数据前,请检查缺失值和可用的观测时间戳。成功的响应也可能包含空页面。

迈出下一步

构建您的第一个 Google Maps 数据工作流。

创建 API 密钥,从一个请求开始,探索您的应用可以使用的数据。