Waze 딥 링크 사용 방법

Waze는 개발자가 Waze 클라이언트 애플리케이션 또는 웹페이지를 열 수 있는 API를 지원합니다 데이터를 전송할 수 있습니다. 이 URL은 다른 모바일 애플리케이션이나 모바일 앱에서 액세스할 수 있습니다. 있습니다.

Waze 딥 링크를 사용하기 위한 기본 URL은 다음과 같습니다.

https://waze.com/ul

그러면 Waze 애플리케이션이 주소를 찾거나, 지도에 주소를 표시하거나, 이 주소에 전달하는 매개변수에 따라 내비게이션 세션을 주소 또는 목적지로 보낼 수 있습니다. URL입니다.

딥 링크의 작동 방식

Waze가 클라이언트 앱으로 열릴지 웹페이지로 열리는지 여부는 사용자의 시스템 설정에 따라 다릅니다.

  • 데스크톱: Waze가 웹페이지로 열립니다.
  • 휴대기기 (및 Waze 앱이 설치되어 있음): Waze 앱이 열립니다.
  • 휴대기기 (및 Waze가 설치되지 않음): Waze가 웹페이지로 열립니다.

Waze 앱이 설치되어 있다면, URL "waze://"를 사용하실 수 있습니다 대상: 앱 간 커뮤니케이션을 구현하지 못할 수 있습니다. 여기에서 설명한 기본 URL 대신 사용됩니다. 참조하세요. 사용자가 Waze를 설치했다고 확신하는 경우에만 이 옵션을 사용하세요. 그렇지 않으면 사용자가 링크를 탭해도 아무 일도 일어나지 않습니다.

Waze 딥 링크 사용

다음 URL을 사용하여 타사 앱, 이메일, SMS, 웹페이지 링크 또는 기타 소스를 명시해야 합니다.

Waze 딥 링크는 다음 URL을 사용합니다.

https://waze.com/ul?param_name=value[&param_name=value]

다음은 여러 가지 일반적인 Waze 딥 링크 작업입니다.

특정 위치로 이동하려면 다음 단계를 따르세요.

  1. Waze 실시간 지도를 열고 내 위치를 검색합니다. 검색창에 검색어를 입력하거나 확대하고 원하는 검색어를 클릭하세요. 지도 세그먼트입니다.
  2. 다음에서 공유 아이콘 을 클릭합니다. 아이콘을 클릭합니다.
  3. 대화상자가 나타납니다. 운전 경로 공유를 클릭한 다음 링크를 복사하여 붙여넣습니다.

다음 예는 뉴욕 타임스스퀘어에 지도의 중심을 맞춥니다.

https://www.waze.com/ul?ll=40.75889500%2C-73.98513100&navigate=yes&zoom=17

Waze 앱에 저장된 아래의 즐겨찾기로 이동할 수 있습니다.

  • work
  • home

다음 URL을 사용하여 지정된 즐겨찾기로 이동합니다.

https://waze.com/ul?favorite=favorite&navigate=yes

다음 예에서는 작동하도록 대상을 설정합니다.

https://waze.com/ul?favorite=work&navigate=yes

다음 구문을 사용하여 주소를 검색합니다.

https://waze.com/ul?q=search_terms

매개변수에 전달하는 값은 URL로 인코딩되어야 합니다. 예를 들어 %20이 있는 스페이스

다음 예는 '66 Acacia Avenue'를 검색합니다.

https://waze.com/ul?q=66%20Acacia%20Avenue

지도에 표시

다음 구문을 사용하여 Waze의 지도 확대 수준 (또는 확대/축소)을 설정합니다. 지도뷰:

https://waze.com/ul?z=magnification_level

magnification_level의 최솟값은 6 (가장 근접하거나 가장 높은 배율)입니다. magnification_level의 최댓값은 8192 (가장 멀리 또는 최소 확대).

다음 예는 확대 수준을 8로 설정합니다.

https://waze.com/ul?z=8

매개변수 결합

이름-값 쌍을 '&'). 다음 예에서는 매개변수 조합을 사용하는 방법을 보여줍니다.

  • 메리힐에 지도의 중심을 맞추고 10으로 확대/축소하려면 다음 단계를 따르세요.

    https://waze.com/ul?ll=45.6906304,-120.810983&z=10
  • 주소를 검색한 후 해당 주소로 이동하는 방법은 다음과 같습니다.

    https://waze.com/ul?q=66%20Acacia%20Avenue&ll=45.6906304,-120.810983&navigate=yes

utm_source 포함

구현에 utm_source를 포함하면 사용을 확인할 수 있습니다 통합에 영향을 미치는 문제가 발생하면 utm_source 을 사용하면 파트너에게 후속 조치를 취하고 더 나은 파트너 경험을 제공할 수 있습니다. 자세한 내용은 자세한 내용은 iOS 예를 참고하세요. 만약 문제가 생기면 문의해 주세요.

이 섹션에서는 Android 및 iOS에서 Waze Deep Links API를 사용하는 방법의 예시를 제공합니다. 지원합니다

Android 예

다음의 코드 스니펫 예는 Waze가 지정된 위치를 찾기 위해 Waze를 실행시킵니다. 설치해야 합니다. Waze가 설치되어 있지 않은 경우, Google Play에서 Waze 페이지가 열립니다.

try {
  // Launch Waze to look for Hawaii:
  String url = "https://waze.com/ul?q=Hawaii";
  Intent intent = new Intent(Intent.ACTION_VIEW, Uri.parse(url));
  startActivity(intent);
} catch (ActivityNotFoundException ex) {
  // If Waze is not installed, open it in Google Play:
  Intent intent = new Intent(Intent.ACTION_VIEW, Uri.parse("market://details?id=com.waze"));
  startActivity(intent);
}

iOS 예

다음 코드 스니펫 예는 Waze가 설치된 경우 위도/경도로 탐색합니다. 그렇지 않으면 App Store를 시작하여 Waze를 설치합니다.

- (void) navigateToLatitude:(double)latitude longitude:(double)longitude
{
  if ([[UIApplication sharedApplication]
    canOpenURL:[NSURL URLWithString:@"waze://"]]) {
      NSString *bundleIdentifier = NSBundle.mainBundle.bundleIdentifier;
      // Waze is installed. Launch Waze and start navigation
      NSString *urlStr =
        [NSString stringWithFormat:@"https://waze.com/ul?ll=%f,%f&navigate=yes&utm_source=%s",
        latitude, longitude, bundleIdentifier];
      [[UIApplication sharedApplication] openURL:[NSURL URLWithString:urlStr]];
  } else {
    // Waze is not installed. Launch AppStore to install Waze app
    [[UIApplication sharedApplication] openURL:[NSURL
      URLWithString:@"http://itunes.apple.com/us/app/id323229106"]];
  }
}

iOS SDK 9.0 이상으로 컴파일하는 경우 애플리케이션의 속성 목록을 업데이트해야 합니다. 로 파일을 첨부하여 Waze를 포함시킵니다.

<key>LSApplicationQueriesSchemes</key>
<array>
  <string>waze</string>
</array>