Apple Maps の URL スキーム:開発者向け完全リファレンス
要点
Apple Maps の URL には 2 つの形式があります。従来の maps.apple.com/?q=…&ll=… はどこでも使え、当サイトを含むほとんどのツールが出力する形式です。Apple の統合 Maps URL(/place、/search、/directions)には iOS 18.4、macOS 15.4 以降が必要です。Google Maps のリンクを変換する。
2 つの形式
-
従来形式 どこでも使える
maps.apple.com/?q=Eiffel+Tower&ll=48.8584,2.2945&z=16
- q:場所の名前
- ll:緯度,経度
- z:ズーム
当サイトの変換ツールやほとんどのツールが出力する形式です。Apple 製デバイスでは Apple Maps アプリが開き、それ以外では Web 地図が開きます。
-
統合形式 iOS 18.4+ · macOS 15.4+
maps.apple.com/place?coordinate=48.8584,2.2945&name=Eiffel%20Tower
- パス:操作の種類
- coordinate(座標)
- 名前
Apple の新しい形式で、watchOS 11.4 以降でも使えます。操作ごとに 1 つのパスがあります:place、search、directions など。
従来形式のパラメータ
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 |
統合 Maps URL
https://maps.apple.com/ にパスとそのパラメータを追加します。短い maps.apple のリンクは、これらにリダイレクトされます。出典: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 | Look Around | coordinate(座標) |
/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 では Apple Maps アプリが開きます:
import UIKit
if let url = URL(string: "https://maps.apple.com/?q=Eiffel+Tower&ll=48.8584,2.2945") {
UIApplication.shared.open(url)
}
Google Maps の URL と Apple Maps の URL の違い
- 座標:Google はパスに入れ(
/@48.8584,2.2945,15z)、Apple はパラメータを使います(ll=48.8584,2.2945、統合 URL ではcoordinate=)。 - プレイス ID:Google の ID は
ChIJ…のような形式です。Apple の統合 URL は独自のplace-idを使います。両者に互換性はないため、変換では名前と座標を引き継ぎます。
Google 側については Google Maps の URL 形式をご覧ください。
URL を使わずにアプリから Apple Maps を開く
iOS や macOS のアプリでは、MapKit の MKMapItem の openInMaps(launchOptions:) で、場所を Apple Maps で直接開けます。Web サイトやメールなど、プラットフォームを問わない用途では、maps.apple.com のリンクのほうが簡単です。
FAQ
Apple Maps の URL は Android でも使えますか?
はい。Android では、maps.apple.com のリンクはブラウザで Web 版の Apple Maps として開きます。アプリはありません。
Apple Maps の URL はメールでも使えますか?
はい。maps.apple.com のリンクはどのメールアプリでも使えます。Apple 製デバイスでは、Apple Maps が直接開きます。
従来形式と統合形式、どちらを使うべきですか?
読者が古いシステムを使っている可能性があるなら、従来の ?q=…&ll=… 形式を使ってください。ほとんどのツールが出力するのもこの形式です。iOS 18.4、macOS 15.4 以降を前提にできるなら、/place や /directions などの統合 URL を使ってください。
Google Maps のリンクを Apple Maps の URL に変えるには?
このページの変換ツールに貼り付けてください。短縮リンクを展開し、場所の名前と座標を読み取って、従来形式の maps.apple.com のリンクを作成します。