Apple-Maps-URL-Schema: vollständige Entwicklerreferenz
Kurz gesagt
Apple Maps hat zwei URL-Formate. Das alte maps.apple.com/?q=…&ll=… funktioniert überall und wird von den meisten Tools ausgegeben, auch von unserem. Apples einheitliche Maps-URLs (/place, /search, /directions) brauchen iOS 18.4, macOS 15.4 oder neuer. Google-Maps-Link konvertieren.
Die zwei Formate
-
Altes Format Funktioniert überall
maps.apple.com/?q=Eiffel+Tower&ll=48.8584,2.2945&z=16
- q: Ortsname
- ll: Breitengrad,Längengrad
- z: Zoom
Das geben unser Konverter und die meisten Tools aus. Öffnet auf Apple-Geräten die Karten-App und anderswo eine Webkarte.
-
Einheitliches Format iOS 18.4+ · macOS 15.4+
maps.apple.com/place?coordinate=48.8584,2.2945&name=Eiffel%20Tower
- Pfad: die Aktion
- coordinate
- Name
Apples neueres Format, auch unter watchOS 11.4+. Ein Pfad pro Aktion: place, search, directions und mehr.
Parameter des alten Formats
Häng sie an https://maps.apple.com/? an, verbunden mit &.
| Parameter | Funktion | Beispiel |
|---|---|---|
q | Ortsname oder Suchtext | q=Eiffel+Tower |
ll | Breitengrad,Längengrad des Pins | ll=48.8584,2.2945 |
z | Zoomstufe | z=16 |
t | Kartentyp: m Standard, k Satellit, h Hybrid | t=k |
saddr | Route: Start | saddr=Louvre+Museum |
daddr | Route: Ziel | daddr=Eiffel+Tower |
dirflg | Verkehrsmittel: d Auto, w zu Fuß, r ÖPNV | dirflg=w |
Einheitliche Maps-URLs
Häng einen Pfad und seine Parameter an https://maps.apple.com/ an. Kurze maps.apple-Links leiten hierhin weiter. Quelle: Apples Dokumentation.
| Pfad | Zeigt | Parameter |
|---|---|---|
/place | Eine Ortskarte | coordinate, name, address, place-id |
/search | Suchergebnisse | query, center, span |
/directions | Route | source, destination, waypoint, mode (driving, walking, transit, cycling), avoid (tolls, highways) |
/frame | Einen Kartenausschnitt | center, span |
/look-around | Umsehen | coordinate |
/guides | Anleitungen | — |
Beispiele zum Kopieren
# 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
Öffne die URL aus einer Swift-App. Auf iPhone und iPad öffnet sie die Karten-App:
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-URLs vs. Apple-Maps-URLs
- Koordinaten: Google schreibt sie in den Pfad (
/@48.8584,2.2945,15z); Apple nutzt einen Parameter (ll=48.8584,2.2945bzw.coordinate=in einheitlichen URLs). - Orts-IDs: Die von Google sehen aus wie
ChIJ…; Apples einheitliche URLs nehmen eine eigeneplace-id. Die beiden lassen sich nicht ineinander übersetzen, daher heißt Konvertieren: Name und Koordinaten übernehmen.
Die Google-Seite findest du unter Google-Maps-URL-Formate.
Karten aus einer App ohne URL öffnen
In einer iOS- oder macOS-App kann MKMapItem aus MapKit einen Ort mit openInMaps(launchOptions:) direkt in Karten öffnen. Für Websites, E-Mails und alles Plattformübergreifende ist ein maps.apple.com-Link einfacher.
FAQ
Funktionieren Apple-Maps-URLs auf Android?
Ja. Auf Android öffnet ein maps.apple.com-Link Apple Maps im Web im Browser – eine App gibt es nicht.
Kann ich Apple-Maps-URLs in E-Mails verwenden?
Ja. maps.apple.com-Links funktionieren in jedem E-Mail-Programm. Auf Apple-Geräten öffnen sie direkt Apple Maps.
Soll ich das alte oder das einheitliche Format verwenden?
Nutze die alte Form ?q=…&ll=…, wenn deine Leser ältere Systeme haben könnten; die meisten Tools geben sie aus. Nutze einheitliche URLs wie /place und /directions, wenn du dich auf iOS 18.4, macOS 15.4 oder neuer verlassen kannst.
Wie mache ich aus einem Google-Maps-Link eine Apple-Maps-URL?
Füge ihn in den Konverter auf dieser Seite ein. Er erweitert Kurzlinks, liest Ortsnamen und Koordinaten aus und erstellt einen maps.apple.com-Link im alten Format.