iOS용 Google 지도 URL 스키마

iOS 9 이상을 실행하는 기기에서는 Google 지도 URL이 있는 경우 범용 링크를 사용하여 Google 지도를 실행할 수 있습니다.

Google 지도 URL 스키마를 사용하여 iOS용 Google 지도 앱을 실행하고 검색을 실행하고, 경로 요청을 가져오고, 지도 뷰를 표시할 수 있습니다. Google 지도를 실행하면 번들 식별자가 요청의 일부로 자동 전송됩니다.

Google 지도 URL 스키마를 사용하기 위해 Google API 키가 필요하지 않습니다.

iOS용 Google 지도는 iOS 9 이상을 실행하는 기기에서 범용 링크를 지원합니다.

URL이 다음 정규 표현식과 일치하고 기기에서 iOS 9 이상을 실행하는 경우 openURL: 메서드를 직접 사용하는 것이 좋습니다.

(http(s?)://)?
((maps\.google\.{TLD}/)|
 ((www\.)?google\.{TLD}/maps/)|
 (goo.gl/maps/))
.*

예를 들면 다음과 같습니다.

Swift

UIApplication.shared.openURL(URL(string:"https://www.google.com/maps/@42.585444,13.007813,6z")!)

Objective-C

[[UIApplication sharedApplication] openURL:
   [NSURL URLWithString:@"https://www.google.com/maps/@42.585444,13.007813,6z"]];

개요

URL 스키마를 사용하면 다른 iOS 앱 또는 웹 애플리케이션에서 네이티브 iOS 애플리케이션을 실행할 수 있습니다. 실행된 애플리케이션에 전달할 옵션을 URL에서 설정할 수 있습니다. iOS용 Google 지도 앱은 다음 URL 스키마를 지원합니다.

  • comgooglemaps:// 및 comgooglemaps-x-callback:// - 이 스키마를 사용하면 iOS용 Google 지도 앱을 실행하고 다음 작업 중 하나를 실행할 수 있습니다.

    • 특정 위치 및 확대/축소 수준에서 지도를 표시합니다.
    • 위치나 장소를 검색하여 지도에 표시합니다.
    • 한 위치에서 다른 위치로 가는 경로를 요청합니다. 운전, 도보, 자전거, 대중교통 등 4가지 이동 수단에 대한 경로를 반환할 수 있습니다.
    • 앱에 탐색을 추가합니다.
    • iOS 8을 통해 앱이 완료되면 comgooglemaps-x-callback://를 사용하여 콜백을 실행합니다. 콜백은 주로 사용자를 원래 iOS용 Google 지도를 연 앱으로 되돌리기 위해 사용됩니다. iOS 9에서는 시스템이 상태 표시줄의 왼쪽 모서리에 '뒤로' 링크를 자동으로 제공합니다.

  • comgooglemapsurl:// - 이 스키마를 사용하면 데스크톱 Google 지도 웹사이트에서 파생된 URL을 사용하여 iOS용 Google 지도 앱을 실행할 수 있습니다. 즉, Google 지도 웹사이트를 로드하는 대신 사용자에게 네이티브 모바일 환경을 제공할 수 있습니다.

    • 기존 URL은 maps.google.com 또는 google.com/maps용일 수 있으며 com 대신 유효한 국가 최상위 도메인을 사용할 수도 있습니다. goo.gl/maps 리디렉션 URL을 전달할 수도 있습니다.
    • comgooglemapsurl:// URL 스킴과 함께 x-source 및 x-success 매개변수를 사용하여 콜백을 실행할 수 있습니다.

iOS용 Google 지도 앱 실행 및 특정 기능 실행

iOS용 Google 지도 앱을 실행하고 원하는 경우 지원되는 함수 중 하나를 실행하려면 다음 형식의 URL 스키마를 사용하세요.

comgooglemaps://?parameters

또는:

comgooglemaps-x-callback://?parameters

매개변수는 이 문서의 뒷부분에서 자세히 설명됩니다.

기기에서 Google 지도 앱을 사용할 수 있는지 확인

앱에서 사용자에게 이러한 URL 중 하나를 표시하기 전에 먼저 애플리케이션이 설치되어 있는지 확인해야 합니다. 앱은 다음 코드를 사용하여 URL 스키마를 사용할 수 있는지 확인할 수 있습니다.

Swift

UIApplication.shared.canOpenURL(URL(string:"comgooglemaps://")!)

Objective-C

[[UIApplication sharedApplication] canOpenURL:
    [NSURL URLWithString:@"comgooglemaps://"]];

예를 들어 뉴욕의 센트럴 파크 지도를 표시하려면 다음 코드를 사용할 수 있습니다.

Swift

if (UIApplication.shared.canOpenURL(URL(string:"comgooglemaps://")!)) {
  UIApplication.shared.openURL(URL(string:
    "comgooglemaps://?center=40.765819,-73.975866&zoom=14&views=traffic")!)
} else {
  print("Can't use comgooglemaps://");
}

Objective-C

if ([[UIApplication sharedApplication] canOpenURL:
     [NSURL URLWithString:@"comgooglemaps://"]]) {
  [[UIApplication sharedApplication] openURL:
   [NSURL URLWithString:@"comgooglemaps://?center=40.765819,-73.975866&zoom=14&views=traffic"]];
} else {
  NSLog(@"Can't use comgooglemaps://");
}

지도 표시

URL 구성표를 사용하여 지정된 확대/축소 수준과 위치에 지도를 표시합니다. 또한 지도 위에 다른 보기를 오버레이하거나 스트리트 뷰 이미지를 표시할 수도 있습니다.

매개변수

다음 매개변수는 모두 선택 항목입니다. 매개변수가 설정되지 않으면 URL 스키마가 iOS용 Google 지도 앱을 실행합니다.

  • center: 지도 뷰포트 중앙 지점입니다. 쉼표로 구분된 latitude,longitude 문자열 형식입니다.
  • mapmode: 표시할 지도 종류를 설정합니다. standard 또는 streetview로 설정할 수 있습니다. 지정하지 않으면 현재 애플리케이션 설정이 사용됩니다.
  • views: 특정 뷰를 사용 설정/사용 중지합니다. satellite, traffic 또는 transit로 설정할 수 있습니다. 쉼표 구분자를 사용하여 여러 값을 설정할 수 있습니다. 값을 지정하지 않고 매개변수를 지정하면 모든 뷰가 삭제됩니다.
  • zoom: 지도의 확대/축소 수준을 지정합니다.

이 URL 예시는 뉴욕을 중심으로 확대/축소 14로 지도와 함께 교통 보기를 표시합니다.

comgooglemaps://?center=40.765819,-73.975866&zoom=14&views=traffic

뉴욕 교통정보 지도

다음은 몇 가지 추가 예입니다.

comgooglemaps://?center=37.788463,-122.392545&zoom=12

comgooglemaps://?center=46.414382,10.013988&mapmode=streetview

이 스키마를 사용하여 지정한 표시 영역 위치의 검색어를 표시할 수 있습니다.

매개변수

지도 표시하는 데 사용되는 매개변수 외에도 검색에서는 q 매개변수를 지원합니다.

  • q: 검색의 쿼리 문자열입니다.

지정된 위치 주변에서 '피자'를 검색하는 URL의 예는 다음과 같습니다.

comgooglemaps://?q=Pizza&center=37.759748,-122.427135

주변의 피자 매장

다음은 몇 가지 추가 예입니다.

comgooglemaps://?q=Steamers+Lane+Santa+Cruz,+CA&center=37.782652,-122.410126&views=satellite,traffic&zoom=15

comgooglemaps://?q=Google+Japan,+Minato,+Tokyo,+Japan&center=35.660888,139.73073&zoom=15&views=transit

경로 표시

이 구성표를 사용하여 두 위치 간의 길찾기를 요청하고 표시합니다. 이동 모드를 지정할 수도 있습니다.

매개변수

  • saddr: 경로 검색의 출발점을 설정합니다. 위도,경도 또는 쿼리 형식 주소일 수 있습니다. 두 개 이상의 결과를 반환하는 쿼리 문자열인 경우 첫 번째 결과가 선택됩니다. 값을 비워두면 사용자의 현재 위치가 사용됩니다.
  • daddr: 경로 검색의 종료 지점을 설정합니다. saddr와 동일한 형식과 동작을 갖습니다.
  • directionsmode: 교통 수단입니다. driving, transit, bicycling 또는 walking로 설정할 수 있습니다.

다음 URL 예시에서는 Google NYC와 JFK 공항 간의 대중교통 경로를 표시합니다.

comgooglemaps://?saddr=Google+Inc,+8th+Avenue,+New+York,+NY&daddr=John+F.+Kennedy+International+Airport,+Van+Wyck+Expressway,+Jamaica,+New+York&directionsmode=transit

경유지 정보

다음은 몇 가지 추가 예입니다.

comgooglemaps://?saddr=Google,+1600+Amphitheatre+Parkway,+Mountain+View,+CA+94043&daddr=Google+Inc,+345+Spear+Street,+San+Francisco,+CA&center=37.422185,-122.083898&zoom=10

comgooglemaps://?saddr=2025+Garcia+Ave,+Mountain+View,+CA,+USA&daddr=Google,+1600+Amphitheatre+Parkway,+Mountain+View,+CA,+United+States&center=37.423725,-122.0877&directionsmode=walking&zoom=17

콜백 URL 지정

콜백 URL을 지정하려면 comgooglemaps-x-callback:// URL 스키마를 사용해야 합니다. 이 스키마는 x-callback-url 사양을 준수합니다. 이 스키마를 사용하여 iOS용 Google 지도 앱을 호출하면 앱이 화면 상단에 버튼을 표시합니다. 이 버튼을 탭하면 지정한 URL에 콜백이 실행됩니다.

comgooglemaps-x-callback://에 대한 요청은 다음과 같은 형식이어야 합니다.

comgooglemaps-x-callback://?parameters

매개변수

x-callback URL 스키마는 comgooglemaps:// URL 스키마와 동일한 매개변수를 허용하며 다음과 같은 추가 매개변수가 있습니다. 두 매개변수 모두 필요합니다.

  • x-source: x-callback 요청을 전송하는 애플리케이션의 이름입니다. 짧은 이름을 권장합니다.
  • x-success: 완료 시 호출할 URL입니다. 이는 사용자가 원래 애플리케이션으로 돌아갈 수 있도록 하는 자체 앱의 URL 스킴인 경우가 많습니다.

콜백 URL에 응답할 수 있도록 앱에서 자체 URL 스키마를 등록해야 합니다.

  1. 애플리케이션이 콜백 요청에 응답할 수 있는 URL 스키마를 등록했는지 확인합니다.
  2. x-source 매개변수에 콜백 버튼의 라벨을 전달합니다.
  3. x-success 매개변수에 콜백 URL을 전달합니다.

다음 예에서는 iOS용 Google 지도 앱을 실행하고 뉴욕을 중심으로 한 지도를 표시합니다. 앱에 'SourceApp'이라는 라벨이 지정된 버튼도 표시됩니다. 'SourceApp' 버튼을 클릭하면 iOS용 Google 지도 앱에서 가상의 URL 스키마 sourceapp://?resume=true에 대한 콜백을 실행합니다.

comgooglemaps-x-callback://?center=40.765819,-73.975866&zoom=14
   &x-success=sourceapp://?resume=true
   &x-source=SourceApp

comgooglemaps:// URL 스키마와 마찬가지로 먼저 iOS용 Google 지도 앱을 기기에서 사용할 수 있고 x-callback URL 스키마를 지원하는지 확인해야 합니다. 앱은 다음 코드를 사용하여 URL 스키마를 사용할 수 있는지 확인할 수 있습니다.

Swift

UIApplication.shared.canOpenURL(URL(string:"comgooglemaps-x-callback://")!)

Objective-C

[[UIApplication sharedApplication] canOpenURL:
   [NSURL URLWithString:@"comgooglemaps-x-callback://"]];

사용자가 디저트를 검색한 후 앱으로 돌아갈 수 있는 URL의 예입니다.

comgooglemaps-x-callback://?q=dessert&center=37.759748,-122.427135
   &x-success=sourceapp://?resume=true
   &x-source=Nom+Nom

앱에 탐색 추가

경로 요청으로 iOS용 Google 지도 앱을 실행하면 사용자가 앱에서 세부 경로 안내를 쉽게 이용할 수 있습니다. comgooglemaps:// 또는 comgooglemaps-x-callback:// URL 스키마 중 하나를 사용할 수 있습니다.

이 코드 스니펫은 comgooglemaps-x-callback:// 스키마를 사용하여 경로를 요청한 다음 사용자가 준비되었을 때 앱으로 돌아가는 방법을 보여줍니다. 이 코드는 다음을 실행합니다.

  1. comgooglemaps-x-callback:// URL 스키마를 사용할 수 있는지 확인합니다.
  2. iOS용 Google 지도 앱을 실행하고 뉴욕시의 JFK 공항으로 가는 길을 요청합니다. 시작 주소를 비워 두면 사용자의 현재 위치에서 경로를 요청할 수 있습니다.
  3. iOS용 Google 지도 앱에 'AirApp'이라는 라벨이 지정된 버튼을 추가합니다. 버튼 라벨은 x-source 매개변수로 정의됩니다.
  4. 사용자가 뒤로 버튼을 클릭하면 가상의 URL 스키마 sourceapp://를 호출합니다.

Swift

let testURL = URL(string: "comgooglemaps-x-callback://")!
if UIApplication.shared.canOpenURL(testURL) {
  let directionsRequest = "comgooglemaps-x-callback://" +
    "?daddr=John+F.+Kennedy+International+Airport,+Van+Wyck+Expressway,+Jamaica,+New+York" +
    "&x-success=sourceapp://?resume=true&x-source=AirApp"

  let directionsURL = URL(string: directionsRequest)!
  UIApplication.shared.openURL(directionsURL)
} else {
  NSLog("Can't use comgooglemaps-x-callback:// on this device.")
}

Objective-C

NSURL *testURL = [NSURL URLWithString:@"comgooglemaps-x-callback://"];
if ([[UIApplication sharedApplication] canOpenURL:testURL]) {
  NSString *directionsRequest = @"comgooglemaps-x-callback://" +
      @"?daddr=John+F.+Kennedy+International+Airport,+Van+Wyck+Expressway,+Jamaica,+New+York" +
      @"&x-success=sourceapp://?resume=true&x-source=AirApp";
  NSURL *directionsURL = [NSURL URLWithString:directionsRequest];
  [[UIApplication sharedApplication] openURL:directionsURL];
} else {
  NSLog(@"Can't use comgooglemaps-x-callback:// on this device.");
}

Google 지도 데스크톱 URL에서 iOS용 Google 지도 앱 실행

앱이 웹페이지 또는 데이터베이스와 같은 기존 Google 지도 URL에 액세스할 수 있는 경우 이 스키마를 사용하여 iOS용 Google 지도 앱에서 URL을 열 수 있으므로 사용자에게 최상의 네이티브 환경을 제공할 수 있습니다.

  1. http:// 또는 https:// 스키마를 comgooglemapsurl://로 바꿉니다.
  2. 콜백을 사용하려면 x-source 및 x-success 매개변수를 포함합니다. 이 스키마는 x-callback-url 사양을 준수합니다.

지원되는 Google 지도 URL 형식

comgooglemapsurl:// 스킴은 이 정규 표현식과 일치하는 URL을 지원합니다. 여기서 {TLD}는 유효한 최상위 국가 도메인을 나타냅니다. 명확성을 위해 줄바꿈이 추가되었습니다.

(http(s?)://)?
((maps\.google\.{TLD}/)|
 ((www\.)?google\.{TLD}/maps/)|
 (goo.gl/maps/))
.*

Google 지도 앱을 사용할 수 있는지 확인하는 중입니다.

먼저 기기에서 iOS용 Google 지도 앱을 사용할 수 있고 URL 스키마를 지원하는지 확인합니다.

Swift

UIApplication.shared.canOpenURL(URL(string:"comgooglemaps-x-callback://")!)

Objective-C

[[UIApplication sharedApplication] canOpenURL:
   [NSURL URLWithString:@"comgooglemapsurl://"]];

예

일반 Google 지도 URL 예시:

원래 Google Maps URL:

https://www.google.com/maps/preview/@42.585444,13.007813,6z

URL 구성표 사용:

comgooglemapsurl://www.google.com/maps/preview/@42.585444,13.007813,6z

일반 Google 지도 URL 예시:

원래 Google Maps URL:

https://maps.google.com/?q=@37.3161,-122.1836

URL 구성표 사용:

comgooglemapsurl://maps.google.com/?q=@37.3161,-122.1836

x-callback을 사용하여 도쿄 타워까지의 경로를 요청하는 예시:

원래 Google Maps URL:

http://maps.google.com/maps?f=d&daddr=Tokyo+Tower,+Tokyo,+Japan&sll=35.6586,139.7454&sspn=0.2,0.1&nav=1

다음 예에서는 iOS용 Google 지도 앱을 실행하고 원래 Google 지도 URL(위)에 지정된 대로 도쿄 타워까지의 경로가 포함된 지도를 표시합니다. 앱에 'SourceApp'이라는 라벨이 지정된 버튼도 표시됩니다. 'SourceApp' 버튼을 클릭하면 iOS용 Google 지도 앱이 가상의 URL 스킴 sourceapp://?resume=true에 대한 콜백을 실행합니다.

comgooglemapsurl://maps.google.com/maps?f=d&daddr=Tokyo+Tower,+Tokyo,+Japan&sll=35.6586,139.7454&sspn=0.2,0.1&nav=1
    &x-source=SourceApp
    &x-success=sourceapp://?resume=true