URL-схема Apple Maps: полный справочник для разработчиков

  • Справочник для разработчиков
  • iOS · macOS · веб
  • Обновлено в сентябре 2026 г.

Коротко

У Apple Maps два формата URL. Классический maps.apple.com/?q=…&ll=… работает везде, и именно его выдаёт большинство инструментов, включая наш. Единым URL Apple Maps (/place, /search, /directions) нужны iOS 18.4, macOS 15.4 или новее. Конвертировать ссылку Google Maps.

Два формата

  • Классический Работает везде

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

    • q: название места
    • ll: широта,долгота
    • z: масштаб

    Его выдают наш конвертер и большинство инструментов. На устройствах Apple открывает приложение Apple Maps, на других — веб-карту.

  • Единый iOS 18.4+ · macOS 15.4+

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

    • путь: действие
    • coordinate
    • название

    Новый формат Apple, работает и в watchOS 11.4+. Для каждого действия свой путь: place, search, directions и другие.

Конвертируйте ссылку прямо сейчас

Вставьте любую ссылку Google Maps — на место, метку, короткую или на маршрут.

Целый список? Воспользуйтесь конвертером файлов.

Параметры классического формата

Добавляйте их после 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 Apple Maps

Добавьте путь и его параметры к 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«Осмотритесь» (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&center=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)
}
URL Google Maps и URL Apple Maps
  • Координаты: Google помещает их в путь (/@48.8584,2.2945,15z), а Apple — в параметр (ll=48.8584,2.2945 или coordinate= в единых URL).
  • ID мест: у Google они выглядят как ChIJ…, а единые URL Apple принимают собственный place-id. Одни в другие не переводятся, поэтому при конвертации переносятся название и координаты.

Сторону Google описывает руководство «Форматы URL Google Maps».

Как открыть Apple Maps из приложения без URL

В приложении для iOS или macOS класс MapKit MKMapItem может сразу открыть место в Apple Maps методом openInMaps(launchOptions:). Для сайтов, писем и всего кроссплатформенного проще ссылка maps.apple.com.

Вопросы и ответы

Работают ли URL Apple Maps на Android?

Да. На Android ссылка maps.apple.com открывает веб-версию Apple Maps в браузере — приложения там нет.

Можно ли использовать URL Apple Maps в письмах?

Да. Ссылки maps.apple.com работают в любом почтовом клиенте. На устройствах Apple они сразу открывают Apple Maps.

Какой формат выбрать: классический или единый?

Используйте классическую форму ?q=…&ll=…, если у ваших читателей могут быть старые системы; именно её выдаёт большинство инструментов. Единые URL, например /place и /directions, подойдут, если можно рассчитывать на iOS 18.4, macOS 15.4 или новее.

Как превратить ссылку Google Maps в URL Apple Maps?

Вставьте её в конвертер на этой странице. Он раскрывает короткие ссылки, считывает название места и координаты и создаёт классическую ссылку maps.apple.com.

Похожие руководства