Schemat URL Apple Maps: pełna dokumentacja dla programistów

  • Dokumentacja dla programistów
  • iOS · macOS · przeglądarka
  • Zaktualizowano: wrzesień 2026

Krótka odpowiedź

Apple Maps ma dwa formaty URL. Starszy maps.apple.com/?q=…&ll=… działa wszędzie i to on jest generowany przez większość narzędzi, w tym nasze. Ujednolicone adresy URL Apple Maps (/place, /search, /directions) wymagają iOS 18.4, macOS 15.4 lub nowszych. Przekonwertuj link z Google Maps.

Dwa formaty

  • Starszy Działa wszędzie

    maps.apple.com/?q=Eiffel+Tower&ll=48.8584,2.2945&z=16

    • q: nazwa miejsca
    • ll: szerokość,długość
    • z: powiększenie

    To generuje nasz konwerter i większość narzędzi. Otwiera Apple Maps na urządzeniach Apple, a gdzie indziej — mapę w przeglądarce.

  • Ujednolicony iOS 18.4+ · macOS 15.4+

    maps.apple.com/place?coordinate=48.8584,2.2945&name=Eiffel%20Tower

    • ścieżka: działanie
    • współrzędne
    • nazwa

    Nowszy format Apple, dostępny też w watchOS 11.4+. Jedna ścieżka na działanie: miejsce, wyszukiwanie, trasa i inne.

Przekonwertuj link teraz

Wklej dowolny link z Google Maps — do miejsca, pinezki, skrócony albo do trasy.

Cała lista? Użyj konwertera plików.

Parametry starszego formatu

Dodaj je po https://maps.apple.com/?, łącząc znakiem &.

ParametrDo czego służyPrzykład
qNazwa miejsca lub tekst wyszukiwaniaq=Eiffel+Tower
llSzerokość,długość geograficzna pinezkill=48.8584,2.2945
zPoziom powiększeniaz=16
tTyp mapy: m standardowa, k satelitarna, h hybrydowat=k
saddrTrasa: począteksaddr=Louvre+Museum
daddrTrasa: celdaddr=Eiffel+Tower
dirflgŚrodek transportu: d samochód, w pieszo, r transport publicznydirflg=w

Ujednolicone adresy URL Apple Maps

Dodaj ścieżkę i jej parametry do https://maps.apple.com/. Krótkie linki maps.apple przekierowują na te adresy. Źródło: dokumentacja Apple.

ŚcieżkaPokazujeParametry
/placeKartę miejscacoordinate, name, address, place-id
/searchWyniki wyszukiwaniaquery, center, span
/directionsTrasęsource, destination, waypoint, mode (driving, walking, transit, cycling), avoid (tolls, highways)
/frameObszar mapycenter, span
/look-aroundRozejrzyj się (Look Around)współrzędne
/guidesPoradniki—

Przykłady do skopiowania

# 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

W aplikacji w Swift otwórz ten URL. Na iPhonie i iPadzie otworzy się 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)
}
Adresy URL Google Maps a adresy URL Apple Maps
  • Współrzędne: Google umieszcza je w ścieżce (/@48.8584,2.2945,15z); Apple używa parametru (ll=48.8584,2.2945 lub coordinate= w ujednoliconych adresach).
  • Identyfikatory miejsc: identyfikatory Google wyglądają jak ChIJ…; ujednolicone adresy Apple przyjmują własny place-id. Nie da się ich przełożyć jednych na drugie, więc konwersja polega na przeniesieniu nazwy i współrzędnych.

Stronę Google opisuje poradnik Formaty URL Google Maps.

Otwieranie Apple Maps z aplikacji bez adresu URL

W aplikacji na iOS lub macOS MKMapItem z MapKit może otworzyć miejsce bezpośrednio w Apple Maps za pomocą openInMaps(launchOptions:). Na stronach internetowych, w e-mailach i wszędzie tam, gdzie liczy się wieloplatformowość, prostszy jest link maps.apple.com.

FAQ

Czy adresy URL Apple Maps działają na Androidzie?

Tak. Na Androidzie link maps.apple.com otwiera Apple Maps w przeglądarce — aplikacji nie ma.

Czy mogę używać adresów URL Apple Maps w e-mailach?

Tak. Linki maps.apple.com działają w każdym programie pocztowym. Na urządzeniach Apple otwierają bezpośrednio Apple Maps.

Którego formatu użyć: starszego czy ujednoliconego?

Użyj starszej postaci ?q=…&ll=…, gdy twoi czytelnicy mogą mieć starsze systemy; to ją generuje większość narzędzi. Ujednolicone adresy, takie jak /place i /directions, stosuj, gdy możesz liczyć na iOS 18.4, macOS 15.4 lub nowsze.

Jak zamienić link z Google Maps na adres URL Apple Maps?

Wklej go do konwertera na tej stronie. Rozwinie skrócone linki, odczyta nazwę miejsca i współrzędne, a potem utworzy link maps.apple.com w starszym formacie.

Powiązane poradniki