Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

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

Waze hỗ trợ một API cho phép nhà phát triển mở ứng dụng Waze hoặc trang web thông qua một URL bên ngoài. Bạn có thể truy cập vào URL này từ một ứng dụng di động khác 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í của một địa chỉ, đánh dấu một địa chỉ trên bản đồ hoặc bắt đầu một phiên chỉ đường đến một địa chỉ hoặc đích đến, dựa trên những thông số mà bạn truyền đến URL này.

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

Waze sẽ mở dưới dạng ứng dụng khách hay trang web tuỳ thuộc vào cấu hình hệ thống của người dùng:

Máy tính: Waze sẽ mở dưới dạng một trang web.
Thiết bị di động (và đã cài đặt ứng dụng Waze): Ứng dụng Waze sẽ mở ra.
Thiết bị di động (và chưa cài đặt Waze): Waze sẽ mở ra dưới dạng một 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 trên web. Đây là URL thay thế cho URL cơ sở được mô tả ở trên. Chỉ sử dụng lựa 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, sẽ không có gì xảy ra nếu người dùng nhấn vào đường liên kết.

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

Bạn có thể dùng URL sau để khởi chạy Waze bằng các tham số từ ứng dụng bên thứ ba, email, SMS, đường liên kết trên trang web hoặc 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 của Waze.

Chỉ đường đến địa điểm

Cách chuyển đến một vị trí cụ thể:

Mở Bản đồ trực tiếp của Waze rồi 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ể trên 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 sẽ xuất hiện trong mã nhúng. Bạn có thể sửa đổi mức thu phóng bằng tham số thu phóng. Để biết thêm thông tin, hãy xem phần Tham số URL.

Ví dụ:

Ví dụ sau đây đặt bản đồ ở trung tâm Quảng trường Thời đại tạ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 những địa điểm yêu thích sau đây đã lưu trong ứng dụng Waze:

work
home

Sử dụng URL sau đây để chuyển đến một mục yêu thích cụ thể:

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

Ví dụ sau đây đặt đích đến là nơi làm việc:

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

Tìm kiếm

Tìm kiếm một địa chỉ bằng cú pháp sau:

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

Các giá trị mà bạn truyền cho tham số phải được mã hoá URL. Ví dụ: bạn phải thay thế khoảng trắng bằng %20.

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 đồ

Sử dụng cú pháp sau để đặt mức phóng đại (hoặc thu phóng) của chế độ xem bản đồ Waze:

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

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

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

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

Kết hợp các thông 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 dấu "&". Các ví dụ sau đây cho thấy cách sử dụng các tổ hợp thông số:

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

Cách tìm kiếm một địa chỉ rồi đi đế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 thêm utm_source vào quá trình triển khai, chúng tôi có thể liên kết mức sử dụng với các đối tác cụ thể. Nếu xảy ra vấn đề ảnh hưởng đến quá trình tích hợp, utm_source sẽ giúp chúng tôi liên hệ với đối tác và mang đến cho họ trải nghiệm tốt hơn. Để biết thêm chi tiết, hãy xem ví dụ về iOS. Nếu bạn gặp phải vấn đề, vui lòng liên hệ với chúng tôi.

Ví dụ

Phần này cung cấp ví dụ về cách sử dụng Waze Deep Links API trên 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 Waze được cài đặt. Nếu Waze chưa được cài đặt, thì ứng dụng này 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 Waze được cài đặt; nếu không, đoạn mã này sẽ khởi 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 iOS SDK 9.0 trở lên, bạn phải cập nhật tệp danh sách thuộc tính của ứng dụng bằng nội dung sau để thêm Waze:

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