苹果地图 URL 方案:完整开发者参考
简短回答
苹果地图有两种 URL 格式。旧版 maps.apple.com/?q=…&ll=… 在所有地方都能使用,也是大多数工具(包括我们的工具)输出的格式。Apple 的统一地图 URL(/place、/search、/directions)需要 iOS 18.4、macOS 15.4 或更高版本。转换谷歌地图链接。
两种格式
-
旧版 处处可用
maps.apple.com/?q=Eiffel+Tower&ll=48.8584,2.2945&z=16
- q:地点名称
- ll:纬度,经度
- z:缩放
我们的转换器和大多数工具输出的格式。在 Apple 设备上打开地图应用,在其他设备上打开网页地图。
-
统一 iOS 18.4+ · macOS 15.4+
maps.apple.com/place?coordinate=48.8584,2.2945&name=Eiffel%20Tower
- 路径:操作类型
- 坐标
- 名称
Apple 较新的格式,也支持 watchOS 11.4+。每种操作对应一个路径:地点、搜索、路线等。
旧版参数
将它们添加到 https://maps.apple.com/? 之后,用 & 连接。
| 参数 | 作用 | 示例 |
|---|---|---|
q | 地点名称或搜索文本 | q=Eiffel+Tower |
ll | 图钉的纬度,经度 | ll=48.8584,2.2945 |
z | 缩放级别 | z=16 |
t | 地图类型:m 标准,k 卫星,h 混合 | t=k |
saddr | 路线:起点 | saddr=Louvre+Museum |
daddr | 路线:目的地 | daddr=Eiffel+Tower |
dirflg | 出行方式:d 驾车,w 步行,r 公共交通 | dirflg=w |
统一地图 URL
在 https://maps.apple.com/ 后添加路径及其参数。maps.apple 短链接会重定向到这些 URL。来源:Apple 官方文档。
| 路径 | 显示内容 | 参数 |
|---|---|---|
/place | 地点卡片 | coordinate、name、address、place-id |
/search | 搜索结果 | query、center、span |
/directions | 路线 | source、destination、waypoint、mode(driving 驾车、walking 步行、transit 公共交通、cycling 骑行)、avoid(tolls 收费路段、highways 高速公路) |
/frame | 地图区域 | center、span |
/look-around | 四处看看 | 坐标 |
/guides | 指南 | — |
可直接复制粘贴的示例
# Legacy: works everywhere https://maps.apple.com/?q=Eiffel+Tower&ll=48.8584,2.2945 https://maps.apple.com/?ll=48.8584,2.2945&t=k&z=17 https://maps.apple.com/?saddr=Louvre+Museum&daddr=Eiffel+Tower&dirflg=w # Unified: iOS 18.4+, macOS 15.4+ https://maps.apple.com/place?coordinate=48.8584,2.2945&name=Eiffel%20Tower https://maps.apple.com/search?query=coffee¢er=48.8584,2.2945 https://maps.apple.com/directions?source=Louvre%20Museum&destination=Eiffel%20Tower&mode=walking
在 Swift 应用中打开该 URL。在 iPhone 和 iPad 上,它会打开地图应用:
import UIKit
if let url = URL(string: "https://maps.apple.com/?q=Eiffel+Tower&ll=48.8584,2.2945") {
UIApplication.shared.open(url)
}
谷歌地图 URL 与苹果地图 URL 对比
- 坐标:Google 把坐标放在路径中(
/@48.8584,2.2945,15z);Apple 使用参数(ll=48.8584,2.2945,统一 URL 中则用coordinate=)。 - 地点 ID:Google 的地点 ID 形如
ChIJ…;Apple 的统一 URL 使用自己的place-id。两者无法互相换算,因此转换时需要带上名称和坐标。
Google 一侧的情况请参阅谷歌地图 URL 格式。
不使用 URL,从应用中打开地图
在 iOS 或 macOS 应用中,MapKit 的 MKMapItem 可以通过 openInMaps(launchOptions:) 直接在地图中打开地点。对于网站、电子邮件以及任何跨平台场景,使用 maps.apple.com 链接更简单。
常见问题
苹果地图 URL 在 Android 上能用吗?
能。在 Android 上,maps.apple.com 链接会在浏览器中打开网页版苹果地图,没有对应的应用。
可以在电子邮件中使用苹果地图 URL 吗?
可以。maps.apple.com 链接适用于任何电子邮件客户端。在 Apple 设备上,它们会直接打开苹果地图。
应该使用旧版格式还是统一格式?
如果您的读者可能使用较旧的系统,请使用旧版 ?q=…&ll=… 格式,大多数工具输出的也是这种格式。如果可以确定对方使用 iOS 18.4、macOS 15.4 或更高版本,请使用 /place 和 /directions 等统一 URL。
如何把谷歌地图链接变成苹果地图 URL?
将它粘贴到本页的转换器中。转换器会展开短链接,读取地点名称和坐标,并生成旧版 maps.apple.com 链接。