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: สินค้าที่เกี่ยวข้อง
- มักใช้ร่วมกับ: Places API (ใหม่)
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