#🗺 MapKit

#简介

• 自定义 Maps app 使用的地图功能与服务版本
• 分别选择调度器、导航与 ETA、评分和照片、定位漂移服务
• 按地图、2D/3D 卫星图像、交通、兴趣点、俯瞰、四处看看、道路、地球与公共交通等类别，分别选择中国大陆版或国际版瓦片数据
• Rewrite 版可在 Pages 正式版、Pages 开发版与 Worker 服务端点之间切换

#解锁步骤

#使用说明

• 启用坐标功能与指南针经纬度:
  • [定位漂移]改为Apple（WGS-84）
  • 默认的自动模式会让 watchOS 使用 Apple，其他系统使用高德
• 查看不同地区与版本的卫星图像:
  • [2D 卫星图像]选择中国版或国际版
  • [3D 卫星图像]选择中国版或国际版，默认为国际版
• 启用俯瞰(Flyover)功能（仅限仍提供此功能的系统版本）:
  • [调度器]改为Apple（维基百科/Yelp/Booking）
  • [3D 卫星图像]与[俯瞰]均改为国际版
• 启用四处看看(Look Around)功能
  • [四处看看]改为国际版
• 注：⌚️ WATCH部分功能有单独的设置面板，不随📍 定位服务模块内的配置而变更

#配置方法

• 基础: 直接使用

  • 采用默认配置

• 进阶: 配合Loon设置面板或Surge参数设置功能进行个性化设置

  • 正式版模块提供 10 项稳定设置

• 高级: 配合BoxJs及订阅使用

  ℹ️ 用前须知：使用BoxJs进行配置将被视为专业用户，官方不受理因使用BoxJs配置导致的各种问题

  1. 安装BoxJs插件并更新引用资源或脚本:
     • 安装方法及下载链接详见: 🧰 BoxJs
  2. 在BoxJs的配置面板中进行个性化设置:
     1. 浏览器访问BoxJs.com
     2. 在应用页面点开 iRingo折叠
     3. 在🗺 MapKit根据需要填写您的设置信息

#BoxJs 设置说明

#动态配置与公告

• [动态配置] 资源清单的国家或地区代码（默认 US）
  • 决定“地图”整体采用哪个国家或地区的功能与服务配置。
  • AUTO跟随用户当前所在地区；也可固定为中国大陆、中国香港、中国台湾、新加坡、美国、日本、澳大利亚、英国、韩国、加拿大或爱尔兰。
  • 此项决定目标资源清单，但下方各类瓦片仍可分别选择CN或XX数据源。
• [公告] 服务环境（默认 AUTO）
  • AUTO: 保留请求与资源清单中的原值。
  • CN: 使用中国大陆环境prod-cn。
  • XX: 使用国际版环境prod。

#URL 信息集

• [URL信息集] 调度器（默认 AutoNavi）
  • AUTO: 保留资源清单原值。
  • AutoNavi: 使用高德、互动百科、大众点评与携程等中国大陆服务，影响搜索、公共指南、兴趣点和位置信息。
  • Apple: 使用 Apple、维基百科、Yelp 与 Booking 等国际版服务。
• [URL信息集] 导航与 ETA（默认 AutoNavi）
  • AutoNavi: 使用高德地图与 TomTom。
  • Apple: 使用 Apple 与 TomTom。
• [URL信息集] 评分和照片（默认 Apple）
  • 在高德与 Apple 的评分、照片及问题反馈服务之间切换。
• [URL信息集] 定位漂移（默认 AUTO）
  • AUTO: watchOS 使用 Apple，其他系统使用高德。
  • AutoNavi: 使用高德定位漂移服务与GCJ-02坐标。
  • Apple: 使用 Apple 服务与WGS-84坐标，可用于指南针显示经纬度。

#瓦片数据集

每个瓦片选项都独立决定对应类别从中国版资源清单（CN）还是国际版资源清单（XX）取得。选择只影响该类别，不会自动联动其他类别。

• [瓦片数据集] 地图（默认 CN）
  • 控制标准地图、地貌、建筑、室内地图及相关底图。
  • CN适合中国大陆；XX使用国际版地图数据。
• [瓦片数据集] 2D 卫星图像（默认 CN）
  • CN: 使用中国四维的中国大陆 2D 卫星图，图像较新且与国内道路坐标对齐，但不提供海外 2D 卫星图。
  • XX: 使用国际版 DigitalGlobe 2D 卫星图，提供全球覆盖；中国大陆区域的图像较旧，并存在坐标偏移。
• [瓦片数据集] 3D 卫星图像（默认 XX）
  • CN: 使用中国版资源清单中的 3D 模型、地表模型与边界数据，不补入国际版主要城市的 3D 数据。
  • XX: 使用国际版 3D 数据，可显示海外主要城市的 3D 卫星模型与地球边界数据。
  • 此项不提供 2D 底图；海外是否有普通 2D 卫星图仍由[2D 卫星图像]决定。

• [瓦片数据集] 交通状况（默认 CN）
  • 控制实时交通、交通事件、历史交通与限速数据；CN使用中国版，XX使用国际版。
• [瓦片数据集] 兴趣点（默认 CN）
  • 控制兴趣点、街道兴趣点、区域选择与繁忙程度数据；CN使用中国版，XX使用国际版。
• [瓦片数据集] 俯瞰（默认 XX）
  • 控制 Flyover 模型、纹理、可见性、天空盒、导航图与元数据。
  • XX用于国际版 Flyover 数据；iOS 26 及以上已移除 Flyover 入口，设置不会恢复系统已移除的功能。
• [瓦片数据集] 四处看看（默认 XX）
  • 控制 Look Around 的元数据、可用道路与分桶数据；XX用于国际版四处看看覆盖。
• [瓦片数据集] 道路（默认 CN）
  • 控制道路、道路标签及道路选区数据；在中国大陆使用CN可保持道路与国内地图数据一致。
• [瓦片数据集] 地球（默认 CN）
  • 控制地球视图模型、材质、行政区划名称与极地数据。
  • CN偏向中国版行政区划与资源，XX使用国际版地球视图资源。
• [瓦片数据集] 公共交通（默认 CN）
  • 控制公共交通线路及选区数据；CN使用中国版，XX使用国际版。

#调试

• [调试] 日志等级（默认 WARN）
  • 可选OFF、ERROR、WARN、INFO、DEBUG或ALL；排查问题时再提高日志详细程度。

#功能列表

• 修改默认(Defaults)配置
  • 终结点(Endpoint): https://configuration.ls.apple.com/config/defaults
  • 已知启用的功能
    • 地图-路线-步行-现实世界中的路线
    • 地图-路线-步行-导航准确性
    • 地图-为“地图”提供助力-评分与照片
    • 地图-为“地图”提供助力-显示评分和照片建议
• 指定通告(Announcements)配置版本
  • 终结点(Endpoint): https://gspe35-ssl.ls.apple.com/config/announcements
• 指定动态(Dynamic)配置版本
  • 终结点(Endpoint): https://gspe35-ssl.ls.apple.com/geo_manifest/dynamic/config
  • 可指定资源清单的国家或地区代码，影响地图整体功能与服务配置
• 指定URL 信息集服务版本
  • 调度器(Dispatcher)
  • 已知影响的功能
    • 地图内公共指南(来自第三方机构的城市与景点旅游指南)
    • 地图内查询与搜索功能
    • 地图内地标与地点的基础信息
    • 地图内兴趣点(POI)的高级信息(来自大众点评或Yelp等第三方的商户信息)
  • 导航与 ETA(Directions & ETA)
  • 评分和照片(Rating and Photo, RAP)
  • 定位漂移(Location Shift)
• 按类别指定瓦片数据集版本
  • 基础地图、地图、2D 卫星图像、3D 卫星图像
  • 交通状况、兴趣点、俯瞰、四处看看
  • 道路、地球、公共交通
  • 每一类均可独立选择中国版(CN)或国际版(XX)，不再提供HYBRID模式
• Rewrite 版服务端点
  • mapkit.pages.dev: 正式版 Pages（默认，直连）
  • dev.mapkit.pages.dev: 开发版 Pages
  • mapkit.nanocat.cloud: Worker 版（需要代理）

#安装链接（v4.7.0-beta1）

#安装链接（稳定版）

#安装链接（Rewrite 版）

#更新日志

#默认设置（v4.7）

• [动态配置] 资源清单的国家或地区代码: US
• [公告] 服务环境: AUTO（保留请求与资源清单原值）
• [URL 信息集]
  • 调度器: AutoNavi
  • 导航与 ETA: AutoNavi
  • 评分和照片: Apple
  • 定位漂移: AUTO（watchOS 使用 Apple，其他系统使用高德）
• [瓦片数据集]
  • 地图: CN
  • 2D 卫星图像: CN
  • 3D 卫星图像: XX
  • 交通状况: CN
  • 兴趣点: CN
  • 俯瞰: XX
  • 四处看看: XX
  • 道路: CN
  • 地球: CN
  • 公共交通: CN
• [储存] 配置类型: Argument
• [调试] 日志等级: WARN

#相关链接

#iOS 18、macOS 15、watchOS 11 及以上

#iOS 17、macOS 14、watchOS 10 及以下