Trang này được dịch bởi Cloud Translation API.

Cách sử dụng Đường liên kết sâu của Waze

Waze hỗ trợ API cho phép nhà phát triển mở ứng dụng khách hoặc trang web Waze qua một URL bên ngoài. Bạn có thể truy cập URL này từ một ứng dụng khác dành cho thiết bị di động hoặc trang web dành cho thiết bị di động.

URL cơ sở để sử dụng Đường liên kết sâu của Waze là:

https://waze.com/ul

Sau đó, ứng dụng Waze có thể xác định vị trí địa chỉ, đánh dấu địa chỉ trên bản đồ hoặc bắt đầu phiên điều hướng đến một địa chỉ hoặc đích đến, dựa trên các tham số bạn chuyển đến URL này.

Cách hoạt động của Đường liên kết sâu

việc Waze mở dưới dạng một ứng dụng khách hay truy cập vào một trang web tùy thuộc vào cấu hình hệ thống của người dùng:

Máy tính: Waze mở ra dưới dạng một trang web.
Thiết bị di động (và ứng dụng Waze đã được cài đặt): Ứng dụng Waze sẽ mở ra.
Thiết bị di động (và Waze chưa được cài đặt): Waze mở ra dưới dạng trang web.

Nếu chắc chắn rằng ứng dụng Waze đã được cài đặt, bạn có thể sử dụng URL "waze://" để giao tiếp giữa các ứng dụng mà không cần trải nghiệm web. URL này thay cho URL cơ sở được mô tả ở trên. Chỉ sử dụng tùy chọn này nếu bạn chắc chắn rằng người dùng đã cài đặt Waze; nếu không, nếu người dùng nhấn vào đường liên kết, thì sẽ không có gì xảy ra.

Sử dụng Đường liên kết sâu của Waze

Bạn có thể sử dụng URL sau để chạy Waze với các thông số từ một ứng dụng bên thứ ba, email, SMS, đường liên kết đến trang web hoặc một nguồn khác.

Đường liên kết sâu của Waze sử dụng URL sau:

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

Sau đây là một số tác vụ phổ biến của Đường liên kết sâu trong Waze.

Chuyển đến vị trí

Để điều hướng đến một vị trí cụ thể:

Mở Waze Live Map và tìm kiếm vị trí của bạn. Nhập vào hộp tìm kiếm hoặc phóng to và nhấp vào một đoạn cụ thể của bản đồ.
Nhấp vào biểu tượng chia sẻ ở góc dưới cùng bên phải của bản đồ.
Một hộp thoại sẽ xuất hiện. Nhấp vào Chia sẻ đường lái xe, sau đó sao chép và dán đường liên kết.
Lưu ý: Mức độ thu phóng của chế độ xem trên Bản đồ trực tiếp được phản ánh trong mã nhúng. Bạn có thể sửa đổi mức thu phóng bằng thông số thu phóng. Để biết thêm thông tin, hãy xem bài viết về các tham số URL.

Ví dụ:

Ví dụ sau đây căn giữa bản đồ tại Quảng trường Thời đại ở New York:

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

Chuyển đến mục yêu thích

Bạn có thể chuyển đến các mục yêu thích đã lưu trong ứng dụng Waze:

work
home

Hãy sử dụng URL sau để chuyển đến một mục yêu thích đã chỉ định:

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

Ví dụ sau đây thiết lập đích đến để hoạt động:

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

Tìm kiếm

Tìm địa chỉ theo cú pháp sau:

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

Các giá trị mà bạn chuyển cho tham số phải được mã hóa URL. Ví dụ: bạn phải thay thế %20 bằng dấu cách.

Ví dụ sau đây tìm kiếm "66 Acacia Avenue":

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

Hiển thị trên bản đồ

Hãy sử dụng cú pháp sau để đặt mức độ phóng to (hoặc thu phóng) của chế độ xem bản đồ trên Waze:

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

Giá trị tối thiểu cho magnification_level là 6 (gần nhất hoặc cao nhất. Giá trị tối đa của magnification_level là 8192 (xa nhất hoặc độ phóng đại nhỏ nhất).

Ví dụ sau đây đặt mức độ phóng to thành 8:

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

Kết hợp các tham số

Bạn có thể sử dụng các thông số cùng nhau trong cùng một URL bằng cách phân tách các cặp tên-giá trị bằng "&" các ví dụ sau cho thấy cách sử dụng các tổ hợp thông số:

Để căn giữa bản đồ trên Maryhill và thu phóng đến 10:
```
https://waze.com/ul?ll=45.6906304,-120.810983&z=10
```

Để tìm kiếm một địa chỉ rồi chuyển đến địa chỉ đó:

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

Bao gồm utm_source

Nếu bạn đưa utm_source vào trong quá trình triển khai, chúng tôi có thể liên kết việc sử dụng với các đối tác cụ thể. Nếu có vấn đề xảy ra ảnh hưởng đến quá trình tích hợp, utm_source sẽ cho phép chúng tôi liên hệ với đối tác đó và mang đến cho họ trải nghiệm phù hợp hơn. Để biết thêm chi tiết, hãy xem ví dụ về iOS. Nếu bạn gặp vấn đề, hãy liên hệ với chúng tôi.

Ví dụ

Phần này đưa ra ví dụ về cách sử dụng API Waze Deep Links trên các nền tảng Android và iOS.

Ví dụ về Android

Ví dụ về đoạn mã sau đây sẽ khởi chạy Waze để tìm vị trí đã chỉ định nếu nếu bạn đã cài đặt Waze. Nếu chưa được cài đặt, Waze sẽ mở trang Waze trong Google Play:

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);
}

Ví dụ về iOS

Ví dụ về đoạn mã sau đây sẽ chuyển đến vĩ độ/kinh độ nếu bạn đã cài đặt Waze; nếu không, ứng dụng sẽ chạy App Store để cài đặt 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"]];
  }
}

Khi biên dịch bằng SDK iOS 9.0 trở lên, bạn phải cập nhật các tệp sau để đưa tệp Waze vào danh sách thuộc tính của ứng dụng:

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