ข้อมูลอ้างอิงฉบับย่อเกี่ยวกับ URL ของ Maps

URL ของ Maps ช่วยให้คุณสร้าง URL แบบสากลข้ามแพลตฟอร์มที่เปิด Google Maps เพื่อทำการค้นหา ขอเส้นทางและการนำทาง แสดงมุมมองแผนที่ สร้างรายการสถานที่ที่น่าสนใจ หรือแสดงภาพพาโนรามาใน Street View ได้ ไวยากรณ์ URL จะเหมือนกันในทุกแพลตฟอร์ม และไม่จำเป็นต้องใช้คีย์ API

URL ของ Maps: ข้อเท็จจริงสำคัญ

  • ผลิตภัณฑ์: URL ของ Maps
  • หรือที่เรียกว่า URL ของ Google Maps
  • หมวดหมู่: Maps
  • แพลตฟอร์ม: URL Scheme
  • ระยะการเปิดตัว: GA
  • วงจร: ใช้งานอยู่
  • ภาพรวม: ภาพรวมของ URL ของ Maps

URL ของ Maps: กรณีที่ควรใช้

ใช้ URL ของ Maps เมื่อ

  • คุณต้องมีลิงก์จากแอป Android, แอป iOS หรือเว็บไซต์ที่เปิด Google Maps เพื่อค้นหาสถานที่หรือแสดงผลการค้นหา
  • คุณต้องเปิด Google Maps พร้อมเส้นทางระหว่างจุดต่างๆ โดยอาจมีจุดอ้างอิง โหมดการเดินทาง หรือการนำทางแบบเลี้ยวต่อเลี้ยวด้วย
  • คุณต้องเปิด Google Maps ไปยังมุมมองแผนที่ รายการสถานที่ที่เลือกไว้ หรือภาพพาโนรามาใน Street View โดยไม่ต้องใช้คีย์ API
  • คุณต้องมีไวยากรณ์ URL 1 รายการที่ทำงานเหมือนกันในเบราว์เซอร์ Android, iOS และเบราว์เซอร์ในเดสก์ท็อป

อย่าใช้ URL ของ Maps ในกรณีต่อไปนี้

  • คุณขอรายละเอียดสถานที่แล้วและต้องการลิงก์ Google Maps ที่จัดรูปแบบไว้ล่วงหน้าสำหรับสถานที่ (ช่อง googleMapsUri หรือ googleMapsLinks) โปรดใช้ Places API (ใหม่) แทน
  • คุณต้องใช้ฟีเจอร์สำหรับอุปกรณ์เคลื่อนที่เท่านั้นเมื่อเปิดแอป Google Maps โดยใช้ Google Maps Intents สำหรับ Android หรือ URL Scheme ของ Google Maps สำหรับ iOS

URL ของ Maps: การตั้งค่า

  • การระบุแหล่งที่มาของการใช้งาน: เพิ่มพารามิเตอร์การค้นหา utm_source (ชื่อแอปพลิเคชันของคุณ) และ utm_campaign (การดำเนินการที่ผู้ใช้ต้องการ เช่น place_details_search) ที่ไม่บังคับลงใน URL ของ Maps
  • เริ่มต้นใช้งาน: ตั้งค่า URL ของ Maps

URL ของ Maps: ข้อผิดพลาดที่พบบ่อย

  • ปัญหา: URL การค้นหาที่มีเพียงละติจูด/ลองจิจูดใน query แสดงหมุดแต่ไม่มีรายละเอียดสถานที่ในแผนที่หรือแผงด้านข้าง วิธีแก้ไข: ใช้ query=PLACE_NAME,ADDRESS หรือเพิ่ม query_place_id ควบคู่ไปกับ query เพื่อแสดงรายละเอียดของสถานที่ที่เจาะจง ดู /maps/documentation/urls/get-started
  • ปัญหา: พารามิเตอร์รหัสสถานที่ (query_place_id, origin_place_id, destination_place_id, waypoint_place_ids) ไม่ทำงานด้วยตัวเอง วิธีแก้ไข: ใส่พารามิเตอร์ฐานที่ตรงกัน (query, origin, destination หรือ waypoints) เสมอเมื่อส่งพารามิเตอร์รหัสสถานที่ ดู /maps/documentation/urls/get-started
  • ปัญหา: ระบบจะละเว้นพารามิเตอร์ waypoints ในผลิตภัณฑ์ Google Maps ที่ไม่รองรับจุดอ้างอิงและมีขีดจำกัดจำนวนที่ขึ้นอยู่กับแพลตฟอร์ม และจะละเว้น dir_action=navigate ในกรณีที่ไม่มีการนำทาง วิธีแก้ไข: ใช้จุดอ้างอิงไม่เกิน 3 จุดสำหรับลิงก์ที่เปิดในเบราว์เซอร์บนมือถือ (หรือ 9 จุดในกรณีอื่นๆ) และอย่าพึ่งพา waypoints หรือ dir_action=navigate ที่ทำงานในผลิตภัณฑ์หรือเส้นทาง Google Maps ทุกรายการ ดู /maps/documentation/urls/get-started#directions-action
  • ปัญหา: Maps และ Street View ใช้ปลายทาง @ เดียวกัน ดังนั้น URL ของแผนที่ที่ไม่มีการดำเนินการที่ถูกต้องอาจไม่แสดงแผนที่ วิธีแก้ไข: ตั้งค่า map_action=map สำหรับมุมมองแผนที่ และ map_action=pano สำหรับภาพพาโนรามาใน Street View ดู /maps/documentation/urls/get-started
  • ปัญหา: หากไม่มี api=1 ใน URL ของ Maps ระบบจะไม่สนใจพารามิเตอร์ทั้งหมดและ Google Maps จะเปิดมุมมองเริ่มต้น วิธีแก้ไข: ใส่ api=1 ใน URL ของ Maps ทุกรายการ (1 เป็นค่าเดียวที่ถูกต้อง) ดู /maps/documentation/urls/get-started#forming-the-url