Google Map Places

Google Map Places API helps you find local businesses, places, reviews, ratings, phone numbers, websites, addresses, and location data from Google Maps.

原始信息汇总

数据集名称

Google Map Places

API 概述

该 API 用于从 Google 地图中查找本地商家、地点、评论、评分、电话号码、网站、地址和位置数据。支持通过关键词和位置搜索、获取结构化商家详情、收集评论以及生成包含评分、联系信息、地址、类别、坐标、营业状态等信息的商机记录。

核心功能与端点

方法	端点	描述
GET	/health	检查 API 可用性。
GET	/api/v1/search	通过关键词和位置搜索 Google 地图地点。
GET	/api/v1/details	获取单个商家的结构化信息。
GET	/api/v1/reviews	获取单个商家的评论。
GET	/api/v1/leads	根据搜索词和位置生成商机记录。
POST	/api/v1/batch/details	批量获取多个地点的详情。
POST	/api/v1/batch/reviews	批量获取多个地点的评论。

关键参数与输入格式

• 地点标识 (place_id_or_url)：支持以下三种格式输入：
  • Google 地图 URL（如 https://www.google.com/maps/place/...）
  • 十六进制地点 ID（如 0x89c259bf6dd90021:0x645ce21be1b31735）
  • ChIJ 开头的地点 ID（如 ChIJIQDZbb9ZwokRNRez4RviXGQ）
• 通用参数：
  • language：响应语言（默认 English）。
  • gl：国家代码，用于本地化结果（默认 us）。

主要功能介绍

1. 搜索地点 (Search Places)：

   • 通过文本查询进行搜索，建议将关键词和位置同时包含在 query 参数中。
   • 支持 limit（每页最大结果数，1-100）和 offset（跳过已去重的结果数）进行分页。

2. 商家详情 (Business Details)：

   • 返回一个商家的完整结构化资料，包括名称、地址、电话、网站、评分、评论数、经纬度、类别、时区、营业状态、照片数等详细信息。

3. 商家评论 (Business Reviews)：

   • 返回一页评论，支持 limit、offset 和 sort_by（newest、relevant、highest_rating、lowest_rating）参数。
   • 通过持续使用 offset=next_offset 请求下一页，直到 has_next_page 为 false，可拉取全部评论。

4. 商机挖掘 (Leads)：

   • 通过业务类别和位置进行搜索，返回包含联系方式、简介、评分、评论数、营业状态及综合评分（lead_score 和 lead_grade）的商机记录。
   • 支持 enrich_websites 参数，尝试从商家网站提取邮箱、社交媒体和联系页面。
   • 支持 min_score 参数筛选最低分。

5. 批量操作 (Batch Details & Batch Reviews)：

   • batch/details：一次性最多提交 20 个地点。
   • batch/reviews：一次性最多提交 10 个地点，并可为每个地点设置最大评论数。

状态码

状态码	含义
200	请求成功完成。
400	无效请求或无效的地点输入。
404	未找到地点。
429	RapidAPI 速率限制。
500	临时服务器错误。

注意事项

• 返回的字段会因商家而异，部分商家可能缺少网站、电话、营业时间等信息。
• 评论内容可能为空（仅评分时）。
• 搜索、评论和商机端点支持去重分页，使用 offset=next_offset 继续下一页。