Apple 지도 URL 스킴: 개발자용 완벽 참고서
간단한 답변
Apple 지도의 URL 형식은 두 가지입니다. 기존 maps.apple.com/?q=…&ll=… 형식은 어디서나 작동하며, 저희 도구를 포함해 대부분의 도구가 이 형식을 출력합니다. Apple의 통합 지도 URL(/place, /search, /directions)은 iOS 18.4, macOS 15.4 이상이 필요합니다. Google 지도 링크 변환하기.
두 가지 형식
-
기존 형식 어디서나 작동
maps.apple.com/?q=Eiffel+Tower&ll=48.8584,2.2945&z=16
- q: 장소 이름
- ll: 위도,경도
- z: 확대/축소
저희 변환기와 대부분의 도구가 출력하는 형식입니다. Apple 기기에서는 지도 앱이, 그 밖의 기기에서는 웹 지도가 열립니다.
-
통합 형식 iOS 18.4+ · macOS 15.4+
maps.apple.com/place?coordinate=48.8584,2.2945&name=Eiffel%20Tower
- 경로(path): 동작
- coordinate
- 이름
Apple의 새로운 형식으로, watchOS 11.4 이상에서도 작동합니다. 동작마다 경로가 하나씩 있습니다: 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 |
통합 지도 URL
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¢er=48.8584,2.2945 https://maps.apple.com/directions?source=Louvre%20Museum&destination=Eiffel%20Tower&mode=walking
Swift 앱에서는 URL을 여세요. iPhone과 iPad에서는 지도 앱이 열립니다:
import UIKit
if let url = URL(string: "https://maps.apple.com/?q=Eiffel+Tower&ll=48.8584,2.2945") {
UIApplication.shared.open(url)
}
Google 지도 URL과 Apple 지도 URL 비교
- 좌표: Google은 경로에 좌표를 넣고(
/@48.8584,2.2945,15z), Apple은 매개변수를 사용합니다(ll=48.8584,2.2945, 통합 URL에서는coordinate=). - 장소 ID: Google의 ID는
ChIJ…형태이고, Apple의 통합 URL은 자체place-id를 사용합니다. 두 ID는 서로 변환되지 않으므로, 변환할 때는 이름과 좌표를 옮깁니다.
Google 쪽은 Google 지도 URL 형식을 참고하세요.
URL 없이 앱에서 지도 열기
iOS 또는 macOS 앱에서는 MapKit의 MKMapItem과 openInMaps(launchOptions:)로 지도에서 장소를 바로 열 수 있습니다. 웹사이트, 이메일 등 여러 플랫폼에서 쓰는 경우에는 maps.apple.com 링크가 더 간단합니다.
자주 묻는 질문
Apple 지도 URL은 Android에서도 작동하나요?
네. Android에서는 maps.apple.com 링크가 브라우저에서 웹용 Apple 지도로 열립니다. 앱은 없습니다.
이메일에 Apple 지도 URL을 사용할 수 있나요?
네. maps.apple.com 링크는 모든 이메일 클라이언트에서 작동합니다. Apple 기기에서는 바로 Apple 지도로 열립니다.
기존 형식과 통합 형식 중 무엇을 써야 하나요?
읽는 사람이 이전 버전의 시스템을 쓸 수도 있다면 기존 ?q=…&ll=… 형식을 사용하세요. 대부분의 도구가 출력하는 형식입니다. iOS 18.4, macOS 15.4 이상을 전제할 수 있다면 /place, /directions 같은 통합 URL을 사용하세요.
Google 지도 링크를 Apple 지도 URL로 바꾸려면 어떻게 하나요?
이 페이지의 변환기에 붙여넣으세요. 단축 링크를 펼치고 장소 이름과 좌표를 읽어 기존 형식의 maps.apple.com 링크를 만들어 줍니다.