Schema URL di Apple Maps: riferimento completo per sviluppatori
In breve
Apple Maps ha due formati di URL. Quello classico, maps.apple.com/?q=…&ll=…, funziona ovunque ed è quello generato dalla maggior parte degli strumenti, compreso il nostro. Gli URL unificati di Apple Maps (/place, /search, /directions) richiedono iOS 18.4, macOS 15.4 o versioni successive. Converti un link di Google Maps.
I due formati
-
Classico Funziona ovunque
maps.apple.com/?q=Eiffel+Tower&ll=48.8584,2.2945&z=16
- q: nome del luogo
- ll: latitudine,longitudine
- z: zoom
È il formato generato dal nostro convertitore e dalla maggior parte degli strumenti. Apre l’app Mappe sui dispositivi Apple e una mappa web altrove.
-
Unificato iOS 18.4+ · macOS 15.4+
maps.apple.com/place?coordinate=48.8584,2.2945&name=Eiffel%20Tower
- percorso: l’azione
- coordinate
- nome
Il formato più recente di Apple, disponibile anche su watchOS 11.4+. Un percorso per ogni azione: place, search, directions e altro.
Parametri del formato classico
Aggiungili dopo https://maps.apple.com/?, uniti da &.
| Parametro | Cosa fa | Esempio |
|---|---|---|
q | Nome del luogo o testo da cercare | q=Eiffel+Tower |
ll | Latitudine,longitudine del segnaposto | ll=48.8584,2.2945 |
z | Livello di zoom | z=16 |
t | Tipo di mappa: m standard, k satellite, h ibrida | t=k |
saddr | Indicazioni: partenza | saddr=Louvre+Museum |
daddr | Indicazioni: destinazione | daddr=Eiffel+Tower |
dirflg | Modalità di spostamento: d in auto, w a piedi, r con i mezzi pubblici | dirflg=w |
URL unificati di Apple Maps
Aggiungi un percorso e i relativi parametri a https://maps.apple.com/. I link brevi maps.apple reindirizzano a questi URL. Fonte: documentazione di Apple.
| Percorso | Mostra | Parametri |
|---|---|---|
/place | La scheda di un luogo | coordinate, name, address, place-id |
/search | Risultati di ricerca | query, center, span |
/directions | Indicazioni | source, destination, waypoint, mode (driving, walking, transit, cycling), avoid (tolls, highways) |
/frame | Un’area della mappa | center, span |
/look-around | Guardati intorno | coordinate |
/guides | Guide | — |
Esempi da copiare e incollare
# 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
Da un’app Swift, apri l’URL. Su iPhone e iPad si apre l’app Mappe:
import UIKit
if let url = URL(string: "https://maps.apple.com/?q=Eiffel+Tower&ll=48.8584,2.2945") {
UIApplication.shared.open(url)
}
URL di Google Maps e URL di Apple Maps a confronto
- Coordinate: Google le mette nel percorso (
/@48.8584,2.2945,15z); Apple usa un parametro (ll=48.8584,2.2945, ocoordinate=negli URL unificati). - ID dei luoghi: quelli di Google hanno la forma
ChIJ…; gli URL unificati di Apple usano un proprioplace-id. I due non si possono convertire l’uno nell’altro, quindi per convertire si trasferiscono il nome e le coordinate.
Per il lato di Google, vedi Formati degli URL di Google Maps.
Aprire Mappe da un’app senza URL
In un’app iOS o macOS, MKMapItem di MapKit può aprire un luogo direttamente in Mappe con openInMaps(launchOptions:). Per siti web, email e tutto ciò che è multipiattaforma, un link maps.apple.com è più semplice.
FAQ
Gli URL di Apple Maps funzionano su Android?
Sì. Su Android, un link maps.apple.com apre Apple Maps sul web nel browser: non esiste un’app.
Posso usare gli URL di Apple Maps nelle email?
Sì. I link maps.apple.com funzionano in qualsiasi client email. Sui dispositivi Apple aprono direttamente Apple Maps.
Meglio il formato classico o quello unificato?
Usa il formato classico ?q=…&ll=… se i tuoi lettori potrebbero avere sistemi meno recenti: è quello generato dalla maggior parte degli strumenti. Usa gli URL unificati come /place e /directions quando puoi contare su iOS 18.4, macOS 15.4 o versioni successive.
Come trasformo un link di Google Maps in un URL di Apple Maps?
Incollalo nel convertitore in questa pagina. Espande i link brevi, legge il nome e le coordinate del luogo e crea un link maps.apple.com in formato classico.