搜索费城的律师商家
将 <API_KEY> 替换为你的平台 API 密钥。真实密钥只放在服务端,不要写进共享链接、截图或日志。
示例使用公开默认查询词 attorney in Philadelphia, PA, USA,并把 limit 设为 5(接口默认 20)。打开页面或复制示例都不会发送请求;实际返回的商家会随数据变化,不保证固定结果。
基础 URL https://api.opendata-api.com
curl -X GET 'https://api.opendata-api.com/api/project/google-maps-extractor/locate-and-search?key=<API_KEY>&limit=5&offset=0&query=attorney+in+Philadelphia%2C+PA%2C+USA'import requests
response = requests.request(
"GET",
"https://api.opendata-api.com/api/project/google-maps-extractor/locate-and-search",
params={
"key": "<API_KEY>",
"limit": "5",
"offset": "0",
"query": "attorney in Philadelphia, PA, USA",
},
timeout=30,
)
response.raise_for_status()
print(response.json())const url = new URL("https://api.opendata-api.com/api/project/google-maps-extractor/locate-and-search");
url.search = new URLSearchParams({
"key": "<API_KEY>",
"limit": "5",
"offset": "0",
"query": "attorney in Philadelphia, PA, USA",
}).toString();
const response = await fetch(url, {
method: "GET",
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
console.log(await response.json());先理清坐标、商家 ID 和续页令牌
- 同一城市要换多个行业词搜索时,可以复用已确认的经纬度中心,免去重复定位;城市、国家或搜索意图一变,就重新定位。以中心点为基准的搜索只是附近的一批商家,不代表全城商家总数。
- business_id 来自商家搜索或自动补全返回的记录,可填 google_id(0x...:0x... 形式)、数字 cid 或以 ChIJ 开头的 place_id;不要自己拼凑,也不要把城市名当作商家 ID。
- 评论和照片的响应里叫 next_token,请求参数却叫 next_page_token。令牌要原样保存,只能配合同一商家、同一排序和同一筛选条件使用;第一页留空,没有令牌、整页重复或达到你设定的页数上限时就停止。
- 语言参数名因接口而异:自动补全、评论和照片相关接口用 lang,商家详情、位置查询、商家搜索和附近搜索用 language。附近搜索没有 limit、offset、zoom 或 radius 参数。
先确认请求状态,再读取商家列表和位置
先看 HTTP 状态码,再看网关返回的 code、message、data 业务状态;确认成功后,再检查 data 里的 status,最后读取商家列表和 location。成功但列表为空,只说明这次查询没有匹配结果,不等于调用失败。
选择找商家、定位、详情、评论或照片任务
- 按城市或坐标查找商家
-
手里只有城市名和行业词时,用“定位并搜索”一次拿到商家列表和解析出的位置;已经确认经纬度时,用“附近搜索”按关键词查周边。结果里的 google_id、place_id 或 cid 可以作为后续接口的 business_id。
- 确认搜索位置
-
输入还不完整时,用自动补全获取地点和地址建议;想先看城市被解析成哪个坐标,用位置查询得到经纬度和缩放级别,它不返回商家列表。
- 查看单个商家详情
-
先通过商家搜索或自动补全拿到商家 ID,再读取这家商家的地址、电话、网站和评分;可选字段会因商家而异,个别字段缺失属于正常情况。
- 分页读取商家评论
-
先拿到商家 ID,第一页不填续页令牌;之后把响应里的 next_token 填入请求的 next_page_token,并保持商家和其他条件不变,没有令牌或内容重复时就停止。
- 浏览商家照片图库
-
先查询照片分类,拿到某个分类的哈希值,再用它筛选照片;照片续页同样把 next_token 填入 next_page_token,并自行设置翻页上限。
地点自动补全
/api/project/google-maps-extractor/autocomplete 根据不完整的搜索词,获取 Google 地图的地点和地址联想建议。
完整文档 →说明
针对用户输入到一半的文字,返回最相关的 Google 地图搜索补全结果,适合用在位置搜索框的输入联想场景。必填参数 query 为搜索文本(例如“los ange”),可选参数包括 country、lang 以及 lat/lng 搜索中心。接口返回 JSON 对象,包含 status(成功时为 true)、request_id、存放联想结果的 data 数组,以及原样回显的 request_params。实测中,查询“los ange”返回了五条联想,每条都带有 title、description、google_id、place_id、latitude、longitude、country 和 type;出现过的 type 取值有 locality、establishment 和 geocode。接口文档还提到 street_address、administrative_area_level_1、route、transit_station 和 political 等类型,但实测中没有出现,而且接口没有 type 参数,因此按类型筛选需要在客户端完成。google_id 和 place_id 的格式分别是 0x...:0x... 与 ChIJ...,与商家类接口接受的 business_id 格式一致。接口文档附带的响应示例是空对象,所以上述字段均来自实测调用。
只有你主动点击测试时才会发送请求 1 个必填参数,4 个可选参数
| 参数 | 位置 | 值 |
|---|---|---|
| query |
当前接口的其他可选参数 (4)
| 参数 | 位置 | 值 |
|---|---|---|
| query | ||
| query | ||
| query | ||
| query |
调用成本暂不可用,未假定任何价格。
商家详情
/api/project/google-maps-extractor/business-details 通过商家 ID、CID 或 place ID 获取单个商家完整的 Google 地图详情记录。
完整文档 →说明
返回单个 Google 地图商家的详情记录。必填参数 business_id 可以是 Google 地图 ID(0x...:0x... 形式)、数字 CID 或 ChIJ... 形式的 place ID,还可以选择性设置 country 和 language。接口返回 JSON 对象,包含 status(成功时为 true)、request_id、data 对象以及回显的 request_params。实测中(用 0x...:0x... ID 查询一家酒店),data 包含:标识字段 google_id、google_mid、place_id 和 cid;name、status、address、full_address 以及 detailed_address 明细(district、street、city、zip_code、state、country);main_category、category_id 和 categories;latitude、longitude、global_plus_code、compound_plus_code 和 time_zone;owner_name、owner_id 和 place_url;website_url、website_domain、phone 和 full_phone;以及 rating、reviews_count、reviews_per_rating、reviews_top_terms、reviews_sample、photos_sample 和 featured_photo。这家酒店的 working_hours、popular_times、menu_url、reservation_url、order_online_url、price_range、competitors 和 posts_sample 均为 null,而 hotel_about、hotel_descriptions 和 hotel_stars 有值,因此其他类型的商家也要预期与类别相关的字段可能为 null 或缺失。CID 和 place ID 这两种输入形式来自接口文档,实测中并未使用。接口文档附带的响应示例是空对象,所以上述字段均来自实测调用。
只有你主动点击测试时才会发送请求 1 个必填参数,2 个可选参数
| 参数 | 位置 | 值 |
|---|---|---|
| query |
当前接口的其他可选参数 (2)
| 参数 | 位置 | 值 |
|---|---|---|
| query | ||
| query |
调用成本暂不可用,未假定任何价格。
商家照片
/api/project/google-maps-extractor/business-photos 按类别筛选并通过游标分页,列出 Google 地图商家的照片和视频。
完整文档 →说明
返回某个 Google 地图商家下的一页照片和视频。必填参数 business_id 为 Google 地图 ID、CID 或 place ID,可选参数包括 category(来自商家照片类别接口的类别哈希)、country、lang、limit(默认 20)和 next_page_token。接口返回 JSON 对象,包含 status(成功时为 true)、request_id、data 数组、指向下一页的 next_token 以及回显的 request_params。实测中设置 limit=5,data 仍返回了 14 条(10 条 photo、4 条 video),每条都带有 id、url、type、label、max_size(宽和高)、aspect_ratio、video_url、video_duration_ms、user_name、user_id、user_profile_url、user_avatar 和 upload_date_text;部分条目的 label 为 null,video_url 和 video_duration_ms 只有视频才有值。由于实测返回的条数超过了请求的 limit,请把 limit 当作每页条数的参考值,如需精确条数请在客户端截取。获取下一页时,把返回的 next_token 值作为 next_page_token 传入即可。接口文档附带的响应示例是空对象,所以上述字段均来自实测调用。
只有你主动点击测试时才会发送请求 1 个必填参数,5 个可选参数
| 参数 | 位置 | 值 |
|---|---|---|
| query | ||
| query | ||
| query | ||
| query | 续页令牌可选:第一页留空,之后只使用同一商家、同一筛选条件下上一页返回的 next_token。令牌会出现在请求地址里,请勿放入共享链接、截图或日志。 |
当前接口的其他可选参数 (2)
| 参数 | 位置 | 值 |
|---|---|---|
| query | ||
| query |
调用成本暂不可用,未假定任何价格。
照片分类
/api/project/google-maps-extractor/business-photos-categories 查询某个谷歌地图商家的照片分类(相册标签),每个分类返回名称和哈希值。
完整文档 →说明
返回某个谷歌地图商家相册中的全部照片分类。必填参数 business_id 支持谷歌地图 ID(形如 0x...:0x...)、数字 CID 或 ChIJ... 格式的 place ID,另可选填 country 和 lang。响应是一个 JSON 对象,包含 status(成功时为 true)、request_id、data 数组以及回显的 request_params。在只传 business_id 的实际测试调用中,data 返回了 12 个条目,每个条目都有 name 和 hash。测试中出现的分类名称有 All、Menu、Food & drink、Vibe,五个菜品标签(Chimichanga、Cobb salad、Quesadilla、Egg roll、Margarita),以及 By owner、Street View & 360 degrees 和 Videos,可见分类列表因商家而异,并不是固定集合。接口文档说明,hash 可作为商家照片接口 category 参数的取值;本次测试没有把两个请求串联起来验证。该接口只返回分类,不返回任何照片。接口文档中公布的响应示例是空对象(422 时为带 detail 条目的校验错误结构),因此上述字段均来自实际测试调用。
只有你主动点击测试时才会发送请求 1 个必填参数,2 个可选参数
| 参数 | 位置 | 值 |
|---|---|---|
| query |
当前接口的其他可选参数 (2)
| 参数 | 位置 | 值 |
|---|---|---|
| query | ||
| query |
调用成本暂不可用,未假定任何价格。
商家评论
/api/project/google-maps-extractor/business-reviews 获取某个谷歌地图商家的评论,包含评分、评论者信息、商家回复,并支持游标翻页。
完整文档 →说明
返回某个谷歌地图商家的一页评论。必填参数 business_id(谷歌地图 ID、CID 或 place ID),可选参数 country、lang、limit(默认 20)、next_page_token 和 sort_by。响应是一个 JSON 对象,包含 status(成功时为 true)、request_id、评论数组 data、用于获取下一页的 next_token,以及回显的 request_params。在 limit=5 的实际测试调用中,data 返回了 5 条评论,next_token 是一个字符串。每条评论包含 id、text、translated_text、time(相对时间文本,如 "4 months ago")、timestamp(Unix 秒级时间戳)、url、rating(样本中出现过 3 和 5)、language、language_translated_text、source(Google)、photos 列表(含 thumbnail_url、full_photo_url、width、height 和 aspect_ratio)、rating_breakdown 条目(id、question、rating)、question_breakdown 条目(id、question、answer、explanation)、评论者字段(user_id、user_name、user_avatar、user_profile_url、user_reviews_count、user_images_count、user_reviews_url、user_is_local_guide、user_local_guide_level),以及 owner_response_* 系列字段,这些字段在样本中全部为 null。要读取下一页,请把返回的 next_token 值作为 next_page_token 传入。sort_by 的可接受取值文档中没有说明,也没有测试过。接口文档中公布的响应示例是空对象,因此上述字段均来自实际测试调用。
只有你主动点击测试时才会发送请求 1 个必填参数,5 个可选参数
| 参数 | 位置 | 值 |
|---|---|---|
| query | ||
| query | ||
| query | 续页令牌可选:第一页留空,之后只使用同一商家、同一筛选条件下上一页返回的 next_token。令牌会出现在请求地址里,请勿放入共享链接、截图或日志。 |
当前接口的其他可选参数 (3)
| 参数 | 位置 | 值 |
|---|---|---|
| query | ||
| query | ||
| query |
调用成本暂不可用,未假定任何价格。
地点搜索
/api/project/google-maps-extractor/locate-and-search 用自由文本查询(如行业加城市)搜索谷歌地图商家,同时返回解析出的位置。
完整文档 →说明
一次请求即可把自由文本查询解析为地图位置,再列出该位置周边找到的商家。必填参数 query(例如 "attorney in Philadelphia, PA, USA"),可选参数 country、language、limit(默认 20)、offset(默认 0)和 zoom(3 为缩小视图,21 为放大视图)。响应是一个 JSON 对象,包含 status(成功时为 true)、request_id、地点数组 data、location 对象以及回显的 request_params。在 limit=5 的实际测试调用中,data 返回了 5 个地点,每个地点有 37 个字段:google_id、google_mid、place_id、cid、name、status(五个全部为 OPEN)、address、full_address、detailed_address 对象(district、street、city、zip_code、state、country)、main_category、category_id、categories、latitude、longitude、time_zone、phone、full_phone、website_url、website_domain、按星期给出的 working_hours、rating、reviews_count、featured_photo、about 属性分组、店主相关字段,以及酒店、价格和预订相关字段(样本中的律师事务所这些字段为 null)。location 对象包含 id、name、altitude、latitude、longitude 和 zoom,其中 id 与 name 为 null,zoom 为 7。文档说明,这个方法把 query 定位与周边搜索两个操作合并在了一起,并建议在反复查询同一区域时,复用返回的 location 去调用周边搜索接口。接口文档中公布的响应示例是空对象,因此上述字段均来自实际测试调用。
只有你主动点击测试时才会发送请求 1 个必填参数,5 个可选参数
| 参数 | 位置 | 值 |
|---|---|---|
| query | ||
| query |
当前接口的其他可选参数 (4)
| 参数 | 位置 | 值 |
|---|---|---|
| query | ||
| query | ||
| query | ||
| query |
调用成本暂不可用,未假定任何价格。
位置查询
/api/project/google-maps-extractor/query-locate 把城市或“行业+地点”这类 Google 地图文本查询解析为纬度、经度和缩放级别。
完整文档 →说明
根据一段查询文字,返回与之最相关的 GPS 坐标,结果是单个位置对象。必填参数 query 可以是宽泛的说法,例如“restaurant in New York City”,也可以是精确的写法,例如“New York City, NY, USA”;另可选填 country、language、lat、lng 和 zoom(按接口文档,缩放范围为 3 到 21,数字越大越放大)。接口文档说明,像“restaurant in New York”这样的查询会解析为纽约本身的坐标,所以返回的是查询所指地点的那个点,而不是商家列表。响应是一个 JSON 对象,包含 status(成功时为 true)、request_id、location 位置对象以及原样回显的 request_params。实测中只设置 query 为“attorney in Philadelphia, PA, USA”,location 里包含 id 和 name(均为 null)、altitude(97787.43,文档未说明单位)、latitude(39.9525839)、longitude(-75.1652215)和 zoom(7),request_params 只回显了 query。接口文档称失败时 status 为 false,但没有捕获到失败调用。接口文档附带的响应示例是空对象,因此上述字段都来自实测调用。
只有你主动点击测试时才会发送请求 1 个必填参数,5 个可选参数
| 参数 | 位置 | 值 |
|---|---|---|
| query |
当前接口的其他可选参数 (5)
| 参数 | 位置 | 值 |
|---|---|---|
| query | ||
| query | ||
| query | ||
| query | ||
| query |
调用成本暂不可用,未假定任何价格。
附近搜索
/api/project/google-maps-extractor/search-nearby 按经纬度和搜索词(如行业)列出周边的 Google 地图商家,返回地址、联系方式和评分等字段。
完整文档 →说明
在给定的搜索中心附近查找地点。必填参数 query 为要找的内容(例如“attorney”),可选的 lat 和 lng 用来指定中心点(示例表单使用 39.9525839 和 -75.1652215),另有 country 和 language 两个代码参数。响应是一个 JSON 对象,包含 status(成功时为 true)、request_id、地点数组 data 以及回显的 request_params。实测以 query=attorney 加示例坐标调用,data 中有 20 个地点,每个地点 37 个字段:google_id、google_mid、place_id、cid、name、status(20 个全部为 OPEN)、address、full_address、detailed_address 对象(district、street、city、zip_code、state、country)、main_category、category_id、categories、latitude、longitude、time_zone、phone、full_phone、website_url、website_domain、reservation_url、reservation_domain、按星期给出的 working_hours、rating、reviews_count、featured_photo、about 属性分组、can_claim,以及 owner_name、owner_id 和 owner_profile_url。在抽样的 20 家律师事务所中,hotel_about、hotel_descriptions、hotel_stars、order_online_url、about_descriptions、price_range 和 price_breakdown 全部为 null,reservation_url 在 20 家中有 8 家有值。回显的 request_params 里,lat、lng 和 query 都是字符串。该接口没有 limit、offset、zoom 或 radius 参数,因此返回行数不由调用方控制,实测返回的是 20 条。接口文档称失败时 status 为 false,但没有捕获到失败调用。接口文档附带的响应示例是空对象,因此上述字段都来自实测调用。
只有你主动点击测试时才会发送请求 1 个必填参数,4 个可选参数
| 参数 | 位置 | 值 |
|---|---|---|
| query | ||
| query | ||
| query |
当前接口的其他可选参数 (2)
| 参数 | 位置 | 值 |
|---|---|---|
| query | ||
| query |
调用成本暂不可用,未假定任何价格。
谷歌地图商家数据能力
把谷歌地图(Google Maps)上的地点数据变成结构化 JSON:用一句文字查询解析出坐标,按经纬度列出周边商家,再用商家 ID 读取单个商家的详情、照片分类、照片和评论。
- 商家搜索:用“行业 + 城市”这类自由文本查询,一次返回商家列表和解析出的位置;也可以按经纬度和关键词搜索周边商家
- 定位与联想:把城市或地址短语解析为经纬度和缩放级别,并为搜索框提供地点、地址的自动补全建议
- 商家详情:按谷歌地图 ID、CID 或 place ID 查询单个商家的地址、坐标、电话、网站、类别、评分和评论数
- 商家评论:评分、评论正文、评论者字段和商家回复,用 next_token 游标逐页读取
- 商家照片:先查相册分类,再按分类筛选照片和视频,同样用游标翻页
适合整理获客名单、监控竞品评论、搭建门店查找和做本地 SEO 巡检,不必自己维护无头浏览器爬虫。商家列表每次只返回有限条数,评论和照片通过 next_token 续页,可选字段会因商家而异。