谷歌地图数据 API:商家搜索、评论与照片采集 — 打开交互式演示
引导式在线测试。想要原始接口文档? 查看接口文档 & 测试 →
接口列表
每次调用都会自动附带你的 API Key。
/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 格式一致。接口文档附带的响应示例是空对象,所以上述字段均来自实测调用。
| 参数 | 位置 | 值 |
|---|---|---|
| query | ||
| 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 这两种输入形式来自接口文档,实测中并未使用。接口文档附带的响应示例是空对象,所以上述字段均来自实测调用。
| 参数 | 位置 | 值 |
|---|---|---|
| query | ||
| 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 传入即可。接口文档附带的响应示例是空对象,所以上述字段均来自实测调用。
| 参数 | 位置 | 值 |
|---|---|---|
| query | ||
| query | ||
| query | ||
| query | ||
| 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 条目的校验错误结构),因此上述字段均来自实际测试调用。
| 参数 | 位置 | 值 |
|---|---|---|
| query | ||
| 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 的可接受取值文档中没有说明,也没有测试过。接口文档中公布的响应示例是空对象,因此上述字段均来自实际测试调用。
| 参数 | 位置 | 值 |
|---|---|---|
| query | ||
| query | ||
| query | ||
| 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 去调用周边搜索接口。接口文档中公布的响应示例是空对象,因此上述字段均来自实际测试调用。
| 参数 | 位置 | 值 |
|---|---|---|
| query | ||
| query | ||
| 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,但没有捕获到失败调用。接口文档附带的响应示例是空对象,因此上述字段都来自实测调用。
| 参数 | 位置 | 值 |
|---|---|---|
| query | ||
| 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,但没有捕获到失败调用。接口文档附带的响应示例是空对象,因此上述字段都来自实测调用。
| 参数 | 位置 | 值 |
|---|---|---|
| query | ||
| query | ||
| query | ||
| query | ||
| query |
调用成本暂不可用,未假定任何价格。