苹果地图 URL 方案:完整开发者参考

  • 开发者参考
  • iOS · macOS · 网页
  • 更新于 2026 年 9 月

简短回答

苹果地图有两种 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&center=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 链接。

相关指南