我们自己的访问统计默认开启。Google Analytics 只在你同意后启用,用来了解公开页面是否有用,不统计登录后的工作台。详见 隐私政策。

Apple 地图

Apple 地图 API

按 Apple 地图地点 ID 一次读 1–50 个地点的详情:地址、坐标、电话、网站、分类、每周营业时间、设施、图片、评分及其来源和几条代表性短评;ID 取自 DuckDuckGo 地图结果或 Apple 地图分享链接,按次计费不按个数。 调用 POST /api/v1/social ;返回结构化 JSON,$0.56 / 千次;失败不计费。

平台运行状态

24h 健康值
正常
正常

30 天趋势

Apple 地图 能力清单

能力做什么单价24 小时运行状态
地点详情places用 places 一次读 1–50 个 Apple 地图地点的详情,按次计费不按个数。$0.56 / 千次正常

点能力名进它的文档:参数、返回字段、代码示例和试用。

Apple 地图 每个接口分别做什么

下面逐个解释 action、必填参数、可选筛选项和允许值。 请求都发到 POST /api/v1/social, 切换 action 时,也要按对应接口调整参数。 同名参数在不同平台、不同接口中可能指向不同对象;请以该条说明中的格式和适用范围为准。

下方只展示平台官方资料,用于核对对象与术语,不表示平台对 EveryInfra 的授权或背书。 本接口接受的参数、字段与能力边界以各条说明为准,不与平台官方 API 直接等同。

能力必填参数可选参数单次条数模式单价返回字段
placesplace_idslanguage—同步$0.56 / 千次place_id · name · url · category · categories · address · city · state · postal_code · country_code · lat · lng · timezone · phone · website · rating · rating_scale · review_count · rating_source · price · open_state · opening_hours · amenities · image_urls · top_reviews · is_claimed · platform

怎么调用 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 商务认领这个地点。
Apple 地图 places 调用流程一次 Apple 地图 places 调用的全过程:向 POST /api/v1/social 发送 platform="apple_maps"、action="places",以及必填参数 place_ids;返回结构化 JSON,含 place_id、name、url、category、categories 等字段;返回列表,计费 $0.56 / 千次,失败与空结果不计费。1 · 请求POST /api/v1/socialplatform: "apple_maps"action: "places"place_idsEveryInfra$0.56 / 千次2 · 响应 · 列表place_idnameurlcategorycategories
一次 Apple 地图 places 调用的全过程:向 POST /api/v1/social 发送 platform="apple_maps"、action="places",以及必填参数 place_ids;返回结构化 JSON,含 place_id、name、url、category、categories 等字段;返回列表,计费 $0.56 / 千次,失败与空结果不计费。

Apple 地图 原始字段名

EveryInfra 统一字段名

左边是 Apple 地图 数据里原本的字段名,右边是我们统一后的。点任意一行看对应关系。106 个平台复用通用字段命名,减少重复适配; 切换平台仍需核对参数、字段集合、类型与空值含义。这里展示映射关系,不是目标的实时返回数据。

Apple 地图 的稀有字段名(当前目录)

这些字段名在当前目录中只出现在不超过 3 个平台,Apple 地图 是其中之一。 这是字段命名的分布,不代表其他平台没有同类信息,也不保证每次响应都含这些字段;具体含义和返回条件仍需逐接口核对。

  • timezone
  • rating_source
  • open_state
  • opening_hours
  • amenities
  • top_reviews
  • is_claimed

返回字段含义

通用字段采用统一命名;切换平台时仍需核对目标格式、字段是否存在、类型、空值与平台特有含义。 机器可读版:/api/v1/social/fields

place_id
Apple 地图地点 ID(纯数字),和请求里的 place_ids 一致。
name
名称。用于账号/商品/商家类能力,指该对象本身的名字。
url
该记录在原平台上的可访问链接。
category
分类名称,取值为原平台的分类体系,未做跨平台归一。
categories
地点的各级分类(如 Dining、Coffee Shop、Cafe)。
address
详细地址,原文透传。
city
城市名,用原平台的语言书写,未做中英归一。
state
州 / 省。
postal_code
邮编。
country_code
两位国家代码。
lat
纬度。
lng
经度。
timezone
地点所在时区(IANA 名)。
phone
联系电话,原文透传,未做号码格式归一。
website
账号或商家填写的外链网址。
rating
评分,按 rating_source 那家的分制(Yelp 为 1–5)。
rating_scale
上一列 rating 的满分。5 表示五星制、10 表示十分制。只在该行有 rating 时出现。
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 商务认领这个地点。
platform
数据来源平台标识,与请求里的 platform 一致(如 xiaohongshu、tiktok)。

请求填写示例

place_ids 填纯数字 Apple 地图地点 ID,一次 1–50 个,取自 duckduckgo_maps 返回行的 apple_maps_id;按次计费,不按个数。

以下为填写格式示意,并非成功调用记录。请替换 API Key 和尖括号中的目标,确认可选筛选项后再调用;示例不保证目标当前有数据。

apple_maps_places.sh
curl -X POST https://api.everyinfra.com/api/v1/social \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"platform":"apple_maps","action":"places","params":{"place_ids":["12971322601039101590"]}}'

记录字段预览(非真实响应)

仅展示 places 的记录字段,不包含外层响应、计费或任务状态。null 只作展示占位,不表示字段类型或实际空值;完整响应须以接口文档与实际调用为准。

fields.preview.json
{
  "place_id": null,
  "name": null,
  "url": null,
  "category": null,
  "categories": null,
  "address": null,
  "city": null,
  "state": null,
  "postal_code": null,
  "country_code": null,
  "lat": null,
  "lng": null,
  "timezone": null,
  "phone": null,
  "website": null,
  "rating": null,
  "rating_scale": null,
  "review_count": null,
  "rating_source": null,
  "price": null,
  "open_state": null,
  "opening_hours": null,
  "amenities": null,
  "image_urls": null,
  "top_reviews": null,
  "is_claimed": null,
  "platform": null
}

常见用例

以下是基于现有接口的接入思路,不是开箱即用的分析或告警功能。字段以实际返回为准,缺失值不按零处理。

Apple 地图地点 API 如何按 ID 批量读营业时间和设施?

用 places 一次读 1–50 个 Apple 地图地点的详情,按次计费不按个数。

查看 places 的 place_ids 参数
  • place_ids 填纯数字 Apple 地图地点 ID,取自 duckduckgo_maps.search 行的 apple_maps_id 或 Apple 地图分享链接里的 auid;不是纯数字的会在扣费前被拒,查不到的 ID 不出行。
  • 每行有地址、坐标、电话、网站、分类、每周营业时间 opening_hours、设施 amenities、图片、价位、评分和评分来源 rating_source(Apple 地图常展示 Yelp、Tripadvisor 等合作方的评分),以及几条代表性点评。

Apple 地图 API 常见问题

Apple 地图 API 怎么调用?

调用 POST /api/v1/social,请求体传 platform="apple_maps"、action 和 params。以 places 为例,必填 place_ids,可选 language。place_ids 填纯数字 Apple 地图地点 ID,一次 1–50 个,取自 duckduckgo_maps 返回行的 apple_maps_id;按次计费,不按个数。 Apple 地图 共 1 个 action,鉴权用 Authorization: Bearer <API Key>,同一把 Key 通 106 个平台。

Apple 地图 API 怎么收费?

$0.56 / 千次,Apple 地图 全部 1 个能力同价。按本页最高能力单价、每次单目标估算,$1 免费额度约可用于 1,798 次 Apple 地图 调用。费用按所选能力与目标数量计算,多目标请求不要按单目标估算;参数错误、鉴权失败和空结果不计费。

Apple 地图 API 一次能返回多少条数据?

Apple 地图 有 1 个列表接口,包括 places。数量参数要逐接口区分目标数、页数和记录数,不能将目录数值直接当作保证返回的条数;具体限制见对应参数与用例,不保证完整历史。

Apple 地图 API 返回哪些字段?

当前目录为 places 列出 place_id、name、url、category、categories、address 等 27 个字段名。字段不保证每次齐全,嵌套位置、类型与空值须按各接口说明核对,同名字段不代表语义可互换。

Apple 地图地点 API 如何按 ID 批量读营业时间和设施?

用 places 一次读 1–50 个 Apple 地图地点的详情,按次计费不按个数。 place_ids 填纯数字 Apple 地图地点 ID,取自 duckduckgo_maps.search 行的 apple_maps_id 或 Apple 地图分享链接里的 auid;不是纯数字的会在扣费前被拒,查不到的 ID 不出行。 每行有地址、坐标、电话、网站、分类、每周营业时间 opening_hours、设施 amenities、图片、价位、评分和评分来源 rating_source(Apple 地图常展示 Yelp、Tripadvisor 等合作方的评分),以及几条代表性点评。

可以先免费试用 Apple 地图 API 吗?

可以。注册免费,在 GitHub 给 everyinfra/everyinfra-agent-plugins 和 everyinfra/seo-skills 两个仓库都点星,就能在控制台「余额与充值」领取 $1 额度(≈720 次数据调用),直接进赠送余额,不用输码,24 小⁠时内有效。请先选择 Apple 地图 的目标接口,用单目标请求核对结果;实际可调用次数取决于能力价格与目标数量,不保证覆盖全部 1 个能力。无需信用卡。

开始调用 Apple 地图 API

在 GitHub 给两个仓库点星领 $1 额度,注册后在控制台领取,24 小⁠时内有效,先选一个 Apple 地图 接口验证结果。

免费开始