วิธีใช้ Deep Link ของ Waze

Waze รองรับ API ที่ช่วยให้นักพัฒนาซอฟต์แวร์เปิดแอปพลิเคชันไคลเอ็นต์หรือหน้าเว็บ Waze ผ่าน URL ภายนอกได้ URL นั้นสามารถเข้าถึงได้จากในแอปพลิเคชันบนอุปกรณ์เคลื่อนที่อื่นหรือหน้าเว็บสําหรับอุปกรณ์เคลื่อนที่

URL พื้นฐานในการใช้ Deep Link ของ Waze คือ

https://waze.com/ul

จากนั้นแอปพลิเคชัน Waze จะค้นหาที่อยู่ ทําเครื่องหมายที่อยู่บนแผนที่ หรือเริ่มเซสชันการนําทางไปยังที่อยู่หรือปลายทางตามพารามิเตอร์ที่คุณส่งไปยัง URL นี้

วิธีการทํางานของ Deep Link

Waze จะเปิดเป็นแอปไคลเอ็นต์หรือหน้าเว็บขึ้นอยู่กับการกําหนดค่าระบบของผู้ใช้ ดังนี้

  • เดสก์ท็อป: Waze จะเปิดเป็นหน้าเว็บ
  • อุปกรณ์เคลื่อนที่ (และแอป Waze ติดตั้งอยู่): แอป Waze จะเปิดขึ้น
  • อุปกรณ์เคลื่อนที่ (และไม่ได้ติดตั้ง Waze): Waze จะเปิดเป็นหน้าเว็บ

หากแน่ใจว่าติดตั้งแอป Waze แล้ว คุณสามารถใช้ URL "waze://" ในการสื่อสารในแอปไปยังแอปได้โดยไม่ต้องมีประสบการณ์การใช้งานเว็บ เพื่อแทนที่ URL พื้นฐานที่อธิบายไว้ข้างต้น ใช้ตัวเลือกนี้ในกรณีที่คุณแน่ใจว่าผู้ใช้ติดตั้ง Waze แล้วเท่านั้น ไม่เช่นนั้น หากผู้ใช้แตะลิงก์ จะไม่มีการดําเนินการใดๆ เกิดขึ้น

ใช้ Deep Link ของ Waze

คุณใช้ URL ต่อไปนี้เพื่อเปิด Waze ที่มีพารามิเตอร์จากแอปของบุคคลที่สาม, อีเมล, SMS, ลิงก์หน้าเว็บ หรือแหล่งที่มาอื่นๆ ได้

Waze Deep Link ใช้ URL ต่อไปนี้

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

ต่อไปนี้เป็นงานทั่วไปของ Waze Deep Link

หากต้องการนําทางไปยังตําแหน่งที่เจาะจง ให้ทําดังนี้

  1. เปิด Waze Live Map แล้วค้นหาตําแหน่งของคุณ พิมพ์ในช่องค้นหาหรือซูมเข้า แล้วคลิกกลุ่มที่ต้องการบนแผนที่
  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

รวมพารามิเตอร์

คุณใช้พารามิเตอร์ต่างๆ ร่วมกันใน URL เดียวกันได้โดยแยกคู่ชื่อ-ค่าด้วย "&" ตัวอย่างต่อไปนี้จะแสดงวิธีใช้พารามิเตอร์ร่วมกัน

  • หากต้องการตั้งศูนย์กลางของแผนที่บนแมรีฮิลล์และซูมไปที่ 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 หากพบปัญหาใดๆ โปรดติดต่อเรา

ตัวอย่าง

ส่วนนี้แสดงตัวอย่างวิธีใช้ Waze Deep Link API ในแพลตฟอร์ม Android และ iOS

ตัวอย่าง Android

ตัวอย่างข้อมูลโค้ดต่อไปนี้จะเปิด Waze เพื่อค้นหาตําแหน่งที่ระบุไว้หากมีการติดตั้ง Waze ไว้ หากไม่ได้ติดตั้ง Waze ก็จะเปิดหน้า Waze ใน 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);
}

ตัวอย่างของ iOS

ตัวอย่างข้อมูลโค้ดต่อไปนี้นําทางไปที่ Lat/lon หากติดตั้ง 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>