怎么调用 Apple 地图 地点详情 API?
places使用 platform="apple_maps"、action="places" 调用“地点详情”能力;返回列表,主要包含 place_id、name、url、category、categories、address 等 27 个字段。
Apple 地图 places 的参数分别是什么意思?
place_ids必填- Apple 地图地点 ID 列表,纯数字,一次 1–50 个(如 ["12971322601039101590"]),取自 duckduckgo_maps.search 行的 apple_maps_id 或 Apple 地图分享链接里的 auid;按次计费,不按个数。
Apple 开发者文档说明 Place ID 在兴趣点的整个生命周期内持续标识同一个地点,可用来取回该地点的信息。这里只确认 Apple 地图的地点有稳定的唯一标识;本接口 place_ids 收的是 Apple 地图链接里的纯数字地点 ID(auid),和 MapKit 的字母数字 Place ID 写法不同、不能互换,该来源也不说明营业时间、设施、评分等字段。官方来源:Apple 开发者文档:用 Place ID 标识唯一地点来源核查:
language可选- 结果语言,如 en-US、zh-CN、ja-JP(也收 en、zh 这类两位写法),默认 en-US。
Apple 地图 返回字段与含义(18)
- place_id
- Apple 地图地点 ID(纯数字),和请求里的 place_ids 一致。
- categories
- 地点的各级分类(如 Dining、Coffee Shop、Cafe)。
- state
- 州 / 省。
- postal_code
- 邮编。
- country_code
- 两位国家代码。
- lat
- 纬度。
- lng
- 经度。
- timezone
- 地点所在时区(IANA 名)。
- rating
- 评分,按 rating_source 那家的分制(Yelp 为 1–5)。
- review_count
- 评分来源站上的点评数。
- rating_source
- 评分和点评来自哪家(Apple 地图多半展示 Yelp 等合作方的评分)。
- price
- 价位,用 $ 个数表示;没有就不出现。
- open_state
- 查询时的营业状态原文(如 Open till 18:00),按地点当地时间。
- opening_hours
- 每周营业时间,键是星期(monday…sunday),值是时段原文列表;不营业的那天不出现。
- amenities
- 设施和服务(如 Accepts Apple Pay、Free Wi-Fi)。
- image_urls
- 地点图片链接。
- top_reviews
- 几条代表性点评(rating、text、posted_at、url),不带点评人信息。
- is_claimed
- 商家是否已在 Apple 商务认领这个地点。