นำผู้ใช้ไปยังรายละเอียดและเส้นทางของสถานที่ใน Google Maps ด้วย URL ของ Maps หรือ Places API

ในโลกที่รับรู้ตำแหน่งในปัจจุบัน ผู้ใช้คาดหวังว่าจะเข้าถึงข้อมูลสถานที่ เส้นทาง และการนําทางได้อย่างราบรื่น ไม่ว่าจะผ่านแอปรับส่งข้อความ แอปการค้นพบตามบริบทในพื้นที่ แพลตฟอร์มโลจิสติกส์และขนส่ง เครื่องมือวางแผนการเดินทาง หรือแพลตฟอร์มข้อมูลอสังหาริมทรัพย์ ผู้ใช้มักต้องดูรายละเอียดสถานที่หรือค้นหาเส้นทางที่ดีที่สุดจากจุด A ถึง B อย่างรวดเร็ว แม้ว่านักพัฒนาแอปจะสร้างประสบการณ์การใช้งานในแอปของตนเองได้ แต่การใช้อินเทอร์เฟซที่ครอบคลุมและคุ้นเคยของ Google Maps จะช่วยให้ได้รับประสบการณ์การใช้งานที่เหนือกว่า

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

https://www.google.com/maps/search/?api=1&query=-33.8567%2C151.2152

URL ของ Maps นี้ใช้ได้กับการเปิด Google Maps และการแสดงตำแหน่งตามละติจูดและลองจิจูด แต่จะไม่แสดงรายละเอียดเกี่ยวกับสถานที่ใดสถานที่หนึ่งแก่ผู้ใช้

ค้นหาโดยใช้เฉพาะละติจูดและลองจิจูด
ค้นหาโดยใช้เฉพาะละติจูดและลองจิจูด

เชื่อมต่อแอปพลิเคชันกับ Google Maps ได้อย่างราบรื่นผ่าน URL ที่ถูกต้อง

เปิดหน้ารายละเอียดสถานที่ใน Google Maps
URL ของ Maps ที่มีชื่อสถานที่ที่ไม่ซ้ำกันจะนำผู้ใช้ไปยังหน้ารายละเอียดของสถานที่นั้นใน Google Maps

Google Maps Platform (GMP) มี 2 วิธีหลักในการสร้าง URL ที่ถูกต้อง ได้แก่ Places API(ใหม่) ซึ่งต้องใช้คีย์ API และ URL ของ Maps ซึ่งไม่มีค่าใช้จ่ายและไม่ต้องใช้คีย์ โซลูชันต่อไปนี้จะจัดการกับสถานการณ์และกรณีการใช้งานต่างๆ

GMP Places API(ใหม่) จะแสดงชุดข้อมูลที่ครอบคลุมเกี่ยวกับสถานที่หนึ่งๆ เมื่อขอฟิลด์ googleMapsUri หรือ googleMapsLinks (โดยระบุในมาสก์ฟิลด์) การตอบกลับของ API จะมีออบเจ็กต์สถานที่ ออบเจ็กต์นี้มี URL ที่จัดรูปแบบไว้ล่วงหน้า ซึ่งสามารถใช้เพื่อเปิดมุมมองที่เกี่ยวข้องได้โดยตรง เช่น มุมมองรายละเอียดสถานที่ใน Google Maps

ตัวอย่าง

คำขอรายละเอียดสถานที่

curl -X GET -H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: YOUR_API_KEY" \
-H "X-Goog-FieldMask: googleMapsUri,googleMapsLinks" \
https://places.googleapis.com/v1/places/ChIJ3S-JXmauEmsRUcIaWtf4MzE

การตอบกลับรายละเอียดสถานที่:

{
    "googleMapsUri": "https://maps.google.com/?cid=3545450935484072529",
    "googleMapsLinks": {
        "directionsUri": "https://www.google.com/maps/dir//''/data=!4m7!4m6!1m1!4e2!1m2!1m1!1s0x6b12ae665e892fdd:0x3133f8d75a1ac251!3e0",
        "placeUri": "https://maps.google.com/?cid=3545450935484072529",
        "writeAReviewUri": "https://www.google.com/maps/place//data=!4m3!3m2!1s0x6b12ae665e892fdd:0x3133f8d75a1ac251!12e1",
        "reviewsUri": "https://www.google.com/maps/place//data=!4m4!3m3!1s0x6b12ae665e892fdd:0x3133f8d75a1ac251!9m1!1b1",
        "photosUri": "https://www.google.com/maps/place//data=!4m3!3m2!1s0x6b12ae665e892fdd:0x3133f8d75a1ac251!10e5"
    }
}

ChIJ3S-JXmauEmsRUcIaWtf4MzE ในตัวอย่างข้างต้นคือรหัสสถานที่ของโรงอุปรากรซิดนีย์ รหัสสถานที่เป็นตัวระบุแบบข้อความที่ระบุสถานที่ในฐานข้อมูล Google Places และใน Google Maps โดยไม่ซ้ำกัน

การเรียกข้อมูลรหัสสถานที่โดยไม่มีค่าใช้จ่าย

หากต้องการเรียกข้อมูลรหัสสถานที่แบบเป็นโปรแกรม คุณสามารถใช้ฟังก์ชันการทำงาน Places API: การค้นหาข้อความ(รหัสเท่านั้น) วิธีนี้ไม่มีค่าใช้จ่ายในการรับรหัสสถานที่ ดูข้อมูลเพิ่มเติมเกี่ยวกับรหัสสถานที่และคำขอ Place API(ใหม่)

คำขอการค้นหาข้อความ(รหัสเท่านั้น) ของ Places API

curl -X POST -d '{"textQuery" : "Sydney Opera House"}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H 'X-Goog-FieldMask: places.id' \
'https://places.googleapis.com/v1/places:searchText'

การตอบกลับการค้นหาข้อความ(รหัสเท่านั้น) ของ Places API

{
  "places": [
    {
      "id": "ChIJ3S-JXmauEmsRUcIaWtf4MzE"
    }
  ]
}

นอกจากนี้ยังสามารถดึงข้อมูลรหัสสถานที่ได้เมื่อผู้ใช้คลิกหรือแตะจุดที่น่าสนใจบนแผนที่ ดูรายละเอียดเพิ่มเติมเกี่ยวกับไอคอนจุดที่น่าสนใจซึ่งคลิกได้(JavaScript, Android, iOS)

การใช้งาน

เมื่อใช้ Places API นักพัฒนาแอปสามารถดึงข้อมูลช่อง googleMapsUri หรือ googleMapsLinks จากการตอบกลับได้ง่ายๆ และใช้เพื่อเปิดมุมมองที่เกี่ยวข้องในแอป Google Maps หรือในเบราว์เซอร์หากไม่ได้ติดตั้งแอป

ฟีเจอร์ คำอธิบาย
directionsUri ลิงก์เพื่อเปิด Google Maps เพื่อแสดงเส้นทางจากตำแหน่งปัจจุบันของผู้ใช้ไปยังสถานที่นี้
placeUri ลิงก์เพื่อเปิด Google Maps ไปยังหน้ารายละเอียดสถานที่สำหรับสถานที่นี้
writeAReviewUri ลิงก์เพื่อเปิด Google Maps ไปยังหน้าเขียนรีวิวของสถานที่นี้
reviewsUri ลิงก์เพื่อเปิด Google Maps ไปยังหน้ารีวิวของสถานที่นี้
photosUri ลิงก์เพื่อเปิด Google Maps ไปยังหน้ารูปภาพของสถานที่นี้

ดูคําแนะนําสําหรับนักพัฒนาซอฟต์แวร์และลองใช้ฟีเจอร์นี้เลย

การใช้ URL ของ Maps

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

การดำเนินการบนแผนที่ที่ใช้ได้มีดังนี้

  • ฟังก์ชันการค้นหาจะเปิดแอป Google Maps หรือในเบราว์เซอร์หากไม่ได้ติดตั้งแอปที่แสดงหมุดสำหรับสถานที่ที่ต้องการ หรือทำการค้นหาทั่วไปและเปิดแผนที่เพื่อแสดงผลลัพธ์

  • ฟังก์ชันเส้นทางจะเปิดแอป Google Maps หรือในเบราว์เซอร์หากไม่ได้ติดตั้งแอปที่แสดงเส้นทางระหว่างจุดหรือเปิดใช้การนําทางแบบเลี้ยวต่อเลี้ยวใน Google Maps สําหรับอุปกรณ์เคลื่อนที่

  • ฟังก์ชันพาโนรามาใน Street View ช่วยให้คุณเปิดโปรแกรมดูภาพเพื่อแสดงรูปภาพ Street View เป็นภาพพาโนรามาแบบอินเทอร์แอกทีฟได้

ไปที่เอกสารประกอบสำหรับนักพัฒนาซอฟต์แวร์เกี่ยวกับ URL ของ GMP Maps เพื่อดูฟังก์ชันและตัวอย่างเพิ่มเติม

เราจะเจาะลึกฟังก์ชันการทํางานหลัก 2 อย่างของ URL ของ Maps ดังนี้

  • การแสดงรายละเอียดสถานที่ใน Google Maps: ส่วนนี้จะอธิบายวิธีสร้าง URL ที่แสดงรายละเอียดของสถานที่หนึ่งๆ ใน Google Maps รวมถึงรายละเอียดวิธีจัดการกับสถานที่ที่มีชื่อซ้ำกันโดยใช้รหัสสถานที่และการค้นหาที่แม่นยำ

  • การให้เส้นทางโดยใช้ URL ของ Maps: ส่วนนี้จะอธิบายวิธีสร้าง URL ที่ให้เส้นทางระหว่างสถานที่ต่างๆ ซึ่งรวมถึงเส้นทางที่มีจุดแวะพักหลายจุดและการนำทางแบบเลี้ยวต่อเลี้ยว

การแสดงรายละเอียดสถานที่ใน Google Maps

ฟังก์ชันการค้นหาใช้พารามิเตอร์ 2 รายการในการค้นหาสถานที่ ซึ่งได้แก่ query(ต้องระบุ) และ query_place_id(ไม่บังคับ)

ต้องระบุพารามิเตอร์ query สำหรับคำขอค้นหาทั้งหมด โดยรับชื่อสถานที่ หรือพิกัดละติจูด/ลองจิจูดที่คั่นด้วยคอมมา หรือข้อความค้นหาทั่วไป

โครงสร้าง URL ของ Search 

https://www.google.com/maps/search/?api=1&parameters

สถานการณ์ 1: การแสดงรายละเอียดสถานที่สำหรับชื่อสถานที่ที่ไม่ซ้ำกัน 

https://www.google.com/maps/search/?api=1&query=Sydney%20Opera%20House
 ในตัวอย่างนี้ มีเพียงชื่อสถานที่เท่านั้น URL นี้จะเปิดหน้ารายละเอียดของโรงอุปรากรซิดนีย์

เปิดหน้ารายละเอียดสถานที่ใน Google Maps
ค้นหาชื่อสถานที่และแสดงรายละเอียดสถานที่

มาดูสถานที่ที่มีชื่อซ้ำกัน จะเกิดอะไรขึ้นเมื่อคุณค้นหาโดยใช้ชื่อที่ไม่ซ้ำกันนี้เท่านั้น ดูสถานการณ์ถัดไป

สถานการณ์ 2: ค้นหาสถานที่ที่มีชื่อซ้ำกัน 

https://www.google.com/maps/search/?api=1&query=7-Eleven

เนื่องจากชื่อสถานที่ไม่ซ้ำกัน URL นี้จะเปิดรายการสถานที่ตั้งของ 7-Eleven ที่อยู่ใกล้เคียงภายในวิวพอร์ต จากนั้นผู้ใช้สามารถเลือกร้านค้าที่ต้องการเพื่อดูรายละเอียด

เปิดหน้ารายการสถานที่ใน Google Maps
หน้ารายการสถานที่สําหรับการค้นหาชื่อที่ไม่ซ้ำกัน

หากต้องการหลีกเลี่ยงรายการสถานที่และเข้าถึงหน้ารายละเอียดที่เฉพาะเจาะจงโดยตรง คุณสามารถใช้วิธีการที่แม่นยำยิ่งขึ้นได้ ดูตัวอย่างถัดไป

สถานการณ์ 3: การแสดงรายละเอียดสถานที่สำหรับชื่อสถานที่ที่ซ้ำกัน

เมื่อจัดการกับชื่อสถานที่ทั่วไป การค้นหาชื่ออย่างง่ายมักจะแสดงรายการสถานที่ หากต้องการลิงก์ไปยังหน้ารายละเอียดที่เฉพาะเจาะจงโดยตรง คุณสามารถใช้วิธีใดวิธีหนึ่งต่อไปนี้

วิธีที่ 1: ใช้การค้นหาที่เฉพาะเจาะจงโดยใช้ชื่อสถานที่และที่อยู่ 

https://www.google.com/maps/search/?api=1&query=7-Eleven%2C37%20Swanston%20St%2C%20Melbourne%20Australia

ใน URL นี้ พารามิเตอร์ query มีรูปแบบเป็นชื่อสถานที่ ที่อยู่ วิธีนี้จะช่วยจำกัดขอบเขตการค้นหาให้แคบลงและลิงก์ไปยังตำแหน่งที่ต้องการโดยตรง

วิธีที่ 2: การใช้รหัสสถานที่

รหัสสถานที่จะระบุสถานที่ในฐานข้อมูล Google Places และใน Google Maps โดยไม่ซ้ำกัน 

https://www.google.com/maps/search/?api=1&query=7-Elevan&query_place_id=ChIJGcmcg7ZC1moRAOacd3HoEwM

ในที่นี้ ChIJGcmcg7ZC1moRAOacd3HoEwM คือรหัสสถานที่ที่ไม่ซ้ำกันสำหรับสถานที่หนึ่งๆ คุณยังคงต้องใช้พารามิเตอร์ query แต่ระบบจะใช้ก็ต่อเมื่อ Google Maps ไม่พบรหัสสถานที่

สถานการณ์ 4: การแสดงรายละเอียดสถานที่โดยใช้พิกัดละติจูดและลองจิจูด รวมถึงรหัสสถานที่

การใช้รหัสสถานที่ช่วยให้มั่นใจได้ว่า Google Maps จะแสดงข้อมูลสถานที่โดยละเอียด

https://www.google.com/maps/search/?api=1&query=-33.8567%2C151.2152&query_place_id=ChIJ3S-JXmauEmsRUcIaWtf4MzE
หน้ารายละเอียดสถานที่โดยใช้ละติจูดและลองจิจูด รวมถึงรหัสสถานที่
หน้ารายละเอียดสถานที่โดยใช้ละติจูดและลองจิจูด รวมถึงรหัสสถานที่

การเรียกดูรหัสสถานที่โดยไม่มีค่าใช้จ่าย

หากต้องการเรียกข้อมูลรหัสสถานที่แบบเป็นโปรแกรม คุณสามารถใช้ฟังก์ชันการทำงาน Places API: การค้นหาข้อความ(รหัสเท่านั้น) วิธีนี้ไม่มีค่าใช้จ่ายในการรับรหัสสถานที่ ดูข้อมูลเพิ่มเติมเกี่ยวกับรหัสสถานที่และคําขอ Place API(ใหม่)

คำขอการค้นหาข้อความ(รหัสเท่านั้น) ของ Places API 

curl -X POST -d '{"textQuery" : "Sydney Opera House"}'
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY'
-H 'X-Goog-FieldMask: places.id'
'https://places.googleapis.com/v1/places:searchText'

การตอบกลับการค้นหาข้อความของ Places API(รหัสเท่านั้น) 

{
  "places": [
    {
      "id": "ChIJ3S-JXmauEmsRUcIaWtf4MzE"
    }
  ]
}

นอกจากนี้ยังสามารถดึงข้อมูลรหัสสถานที่ได้เมื่อผู้ใช้คลิกหรือแตะจุดที่น่าสนใจบนแผนที่ ดูรายละเอียดเพิ่มเติมเกี่ยวกับไอคอนจุดที่น่าสนใจซึ่งคลิกได้(JavaScript, Android, iOS)

สรุป

การระบุรายละเอียดสถานที่ที่ถูกต้องเป็นสิ่งสำคัญอย่างยิ่งต่อประสบการณ์การใช้งานที่ดี โปรดสร้าง URL ของ Search โดยใช้รูปแบบที่แนะนำรูปแบบใดรูปแบบหนึ่งต่อไปนี้เพื่อให้ผู้ใช้ไปยังหน้ารายละเอียดสถานที่ที่ถูกต้อง

  • query=PLACE_NAME, ADDRESS
  • query=PLACE_NAME&query_place_id=PLACE_ID

หลีกเลี่ยงการใช้เฉพาะพิกัดละติจูด/ลองจิจูดในพารามิเตอร์ query เมื่อเป้าหมายของคุณคือการแสดงรายละเอียดของสถานที่หนึ่งๆ รูปแบบอย่าง query=latitude,longitude, query=PLACE_NAME,latitude,longitude หรือ query=ADDRESS,latitude,longitude จะไม่นําไปยังหน้ารายละเอียดสถานที่ที่ต้องการเสมอไป แต่จะแสดงละติจูดและลองจิจูดของสถานที่แทน

การค้นหาแบบหมวดหมู่โดยใช้ URL ของ Maps

ในการค้นหาแบบหมวดหมู่ คุณจะส่งคำค้นหาทั่วไป และ Google Maps จะพยายามค้นหาข้อมูลซึ่งตรงกับเกณฑ์ของคุณใกล้กับสถานที่ที่คุณระบุ หากไม่ได้ระบุสถานที่ Google Maps จะพยายามค้นหาข้อมูลที่อยู่ใกล้กับตำแหน่งปัจจุบันของคุณ

สถานการณ์ 1: การค้นหาสถานที่ใกล้เคียง

https://www.google.com/maps/search/?api=1&query=Cafe%20near%20Sydney%20Opera%20House%20that%20are%20open%20now
การค้นหาแบบหมวดหมู่ - สถานที่ใกล้เคียง
การค้นหาแบบหมวดหมู่ - สถานที่ใกล้เคียง

การให้เส้นทางโดยใช้ URL ของ Maps

ฟังก์ชันเส้นทางจะแสดงเส้นทางระหว่างจุดที่ระบุ 2 จุดขึ้นไปบนแผนที่ รวมถึงระยะทางและเวลาเดินทาง ซึ่งช่วยให้นักพัฒนาแอปควบคุมเส้นทางที่ระบุได้มากขึ้น เอกสารประกอบเส้นทางของ URL ของ Maps ของ GMP มีวิธีการโดยละเอียดในการสร้าง URL สำหรับเส้นทางที่กำหนดเอง

โครงสร้าง URL ของเส้นทาง 

https://www.google.com/maps/dir/?api=1&parameters

สถานการณ์ 1: การค้นหาเส้นทางที่ดีที่สุดจากตำแหน่งปัจจุบันของผู้ใช้ไปยังจุดหมาย

https://www.google.com/maps/dir/?api=1&destination=Flinders%20Station%20Melbourne&travelmode=driving

URL นี้จะเปิด Google Maps และแสดงเส้นทางขับรถจากตำแหน่งปัจจุบันของผู้ใช้

ใน URL นี้จะไม่มี origin หากไม่ใส่ origin ระบบจะกำหนดเส้นทางเริ่มต้นเป็นตำแหน่งที่เกี่ยวข้องที่สุด เช่น ตำแหน่งอุปกรณ์ (หากมี) หากไม่มี แผนที่ที่ได้จะมีแบบฟอร์มเพื่อให้ผู้ใช้ป้อนต้นทาง ค่าของต้นทางและปลายทางอาจเป็นชื่อสถานที่ ที่อยู่ หรือพิกัดละติจูด/ลองจิจูดที่คั่นด้วยคอมมา

travelmode เป็นพารามิเตอร์ที่ไม่บังคับ ซึ่งจะกําหนดวิธีการเดินทาง พารามิเตอร์นี้สามารถตั้งค่าเป็น

  • ขับรถ
  • เดิน
  • จักรยาน
  • มอเตอร์ไซค์
  • แผนการเดินทาง

หากไม่ได้ระบุ travelmode ไว้ Google Maps จะแสดงโหมดที่เกี่ยวข้องมากที่สุดอย่างน้อย 1 โหมดสำหรับเส้นทางที่ระบุและ/หรือค่ากำหนดของผู้ใช้

นอกจากนี้ นักพัฒนาแอปยังระบุรหัสสถานที่ได้ด้วยโดยใช้พารามิเตอร์ origin_place_id และ destination_place_id การใช้รหัสสถานที่เป็นวิธีที่มีประสิทธิภาพที่สุดในการลิงก์ไปยังสถานที่ที่ถูกต้อง

การเรียกข้อมูลรหัสสถานที่โดยไม่มีค่าใช้จ่าย

หากต้องการเรียกข้อมูลรหัสสถานที่แบบเป็นโปรแกรม คุณสามารถใช้ฟังก์ชันการทำงาน Places API: การค้นหาข้อความ(รหัสเท่านั้น) วิธีนี้ไม่มีค่าใช้จ่ายในการรับรหัสสถานที่ ดูข้อมูลเพิ่มเติมเกี่ยวกับรหัสสถานที่และคําขอ Place API(ใหม่)

คำขอการค้นหาข้อความ(รหัสเท่านั้น) ของ Places API 

curl -X POST -d '{"textQuery" : "Sydney Opera House"}'
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY'
-H 'X-Goog-FieldMask: places.id'
'https://places.googleapis.com/v1/places:searchText'

การตอบกลับการค้นหาข้อความของ Places API(รหัสเท่านั้น) 

{
  "places": [
    {
      "id": "ChIJ3S-JXmauEmsRUcIaWtf4MzE"
    }
  ]
}

นอกจากนี้ยังสามารถดึงข้อมูลรหัสสถานที่ได้เมื่อผู้ใช้คลิกหรือแตะจุดที่น่าสนใจบนแผนที่ ดูรายละเอียดเพิ่มเติมเกี่ยวกับไอคอนจุดที่น่าสนใจซึ่งคลิกได้(JavaScript, Android, iOS)

เส้นทางจากตำแหน่งปัจจุบันของผู้ใช้
เส้นทางจากตำแหน่งปัจจุบันของผู้ใช้

สถานการณ์ที่ 3: การให้การนำทางแบบเลี้ยวต่อเลี้ยว

https://www.google.com/maps/dir/?api=1&destination=Flinders%20Station%20Melbourne&travelmode=driving&dir_action=navigate

การตั้งค่า dir_action=navigate ใน URL จะเปิด Google Maps ในโหมดการนําทางแบบเลี้ยวต่อเลี้ยวหากตําแหน่งปัจจุบันของผู้ใช้(ตําแหน่งของอุปกรณ์) พร้อมใช้งานและใช้เป็นจุดเริ่มต้น (ระบุไว้อย่างชัดเจนหรือใช้โดยนัยเมื่อไม่มีพารามิเตอร์จุดเริ่มต้น) มิฉะนั้น ระบบจะแสดงตัวอย่างเส้นทาง

ระบบจะเปิดการนำทางแบบเลี้ยวต่อเลี้ยวเมื่อตั้งค่า dir_action=navigate และมีคุณสมบัติดังนี้

  • ระบุต้นทางแล้วและอยู่ใกล้กับตำแหน่งปัจจุบันของผู้ใช้
  • ละต้นทางไว้และระบุตำแหน่งปัจจุบันของผู้ใช้

ระบบจะเปิดตัวอย่างเส้นทางในกรณีต่อไปนี้

  • dir_action=navigate ไม่ได้ตั้งค่าไว้
  • มีการตั้งค่า dir_action=navigate และระบุต้นทางแล้ว และต้นทางนั้นอยู่ไม่ใกล้กับตำแหน่งปัจจุบันของผู้ใช้
  • มีการตั้งค่า dir_action=navigate และไม่มีต้นทาง และตำแหน่งปัจจุบันของผู้ใช้ไม่พร้อมใช้งาน

โปรดทราบว่าการนำทางอาจไม่พร้อมใช้งานในผลิตภัณฑ์ Google Maps บางรายการ เช่น Google Maps บนเว็บ และ/หรือระหว่างปลายทางบางแห่ง ในกรณีดังกล่าว ระบบจะละเว้นพารามิเตอร์นี้

การนำทางแบบเลี้ยวต่อเลี้ยว ตัวอย่างเส้นทาง
การนำทางแบบเลี้ยวต่อเลี้ยว
แสดงตัวอย่างเส้นทาง

สรุป

การสร้าง URL ของ Maps อย่างถูกต้องจะช่วยให้ผู้ใช้ได้รับข้อมูลที่ถูกต้องที่ต้องการได้อย่างรวดเร็วและมีประสิทธิภาพ

  • ระบุปลายทางเสมอ และใช้รหัสสถานที่ทุกครั้งที่เป็นไปได้เพื่อให้มั่นใจว่ามีความแม่นยำ

  • เมื่อเป้าหมายคือการนําทางทันที ให้ใส่พารามิเตอร์ dir_action=navigate เพื่อเรียกใช้การนําทางแบบเลี้ยวต่อเลี้ยว การนําทางจะเริ่มต้นจากตําแหน่งปัจจุบันของผู้ใช้หากตําแหน่งของอุปกรณ์พร้อมใช้งานและใช้เป็นแหล่งที่มา (ตั้งค่าอย่างชัดเจนหรือไม่ระบุก็ได้)

การเลือกแนวทางที่เหมาะสมสําหรับแอปพลิเคชัน

คุณมี 2 ตัวเลือกหลัก ได้แก่ ใช้ประโยชน์จาก URL ที่จัดรูปแบบไว้ล่วงหน้าซึ่ง Places API ให้มา หรือสร้าง URL ของ Maps ด้วยตนเองในแอปพลิเคชัน แต่ละวิธีมีข้อดีและข้อเสียของตัวเอง

Places API

  • ฟิลด์ googleMapsUri และ googleMapsLinks ในการตอบกลับรายละเอียดสถานที่จะให้ URL ที่พร้อมใช้งาน ซึ่งจะช่วยลดเวลาในการพัฒนาและลดความเสี่ยงที่จะเกิดข้อผิดพลาดในการวางรูปแบบ URL

  • ควบคุมการกำหนดค่าเส้นทางได้น้อยลง แม้ว่า googleMapsLinks จะแสดงเส้นทางพื้นฐาน แต่ก็ไม่รองรับจุดแวะพักหรือการปรับแต่งขั้นสูง นอกจากนี้ การเปิดใช้งานการนําทางแบบเลี้ยวต่อเลี้ยวโดยตรงยังค่อนข้างซับซ้อนกว่า

URL ของ Maps

  • มีความยืดหยุ่นและการควบคุมที่มากขึ้น นักพัฒนาแอปสามารถสร้าง URL เพื่อแสดงรายละเอียดสถานที่และกำหนดค่าแง่มุมต่างๆ ของเส้นทางได้ ซึ่งรวมถึงการเพิ่มจุดแวะพัก ระบุโหมดการเดินทาง และเริ่มการนําทางแบบเลี้ยวต่อเลี้ยว

  • ต้องใช้ความเข้าใจที่ลึกซึ้งยิ่งขึ้นเกี่ยวกับพารามิเตอร์และโครงสร้างของ URL การสร้างด้วยตนเองมีโอกาสเกิดข้อผิดพลาดได้หากไม่ดำเนินการอย่างระมัดระวัง

การปรับปรุง URL ของ Maps ด้วยพารามิเตอร์ UTM

เราขอแนะนำให้คุณใส่พารามิเตอร์การติดตาม UTM ไว้ในโครงสร้าง URL เพื่อช่วยให้ Google เข้าใจวิธีที่นักพัฒนาซอฟต์แวร์ผสานรวม URL ของ Maps ได้ดียิ่งขึ้นและเพื่อประสิทธิภาพที่ดีที่สุด การเพิ่มพารามิเตอร์ utm_source และ utm_campaign เป็นการให้ข้อมูลที่มีค่าซึ่งช่วยให้เราวิเคราะห์รูปแบบการใช้งานและปรับปรุงผลิตภัณฑ์ URL ของ Maps ได้

สําหรับพารามิเตอร์ utm_source ให้ใช้ชื่อแอปพลิเคชัน พารามิเตอร์ utm_campaign ควรแสดงถึงการดำเนินการที่ผู้ใช้ตั้งใจ เช่น "location_sharing" "place_details_search" หรือ "directions_request"

ตัวอย่างเช่น URL ที่มีพารามิเตอร์ UTM อาจมีลักษณะดังนี้ 

https://www.google.com/maps/search/?api=1&query=Sydney+Opera+House&query_place_id=ChIJ3S-JXmauEmsRUcIaWtf4MzE&utm_source=YourAppName&utm_campaign=place_details_search

การใช้พารามิเตอร์เหล่านี้อย่างสม่ำเสมอช่วยให้เราระบุจุดที่ควรปรับปรุง แก้ปัญหาได้อย่างมีประสิทธิภาพมากขึ้น และมอบประสบการณ์การใช้งานที่ดีขึ้นให้แก่ผู้ใช้ทุกคนในที่สุด

ขั้นตอนถัดไป

แหล่งข้อมูลอื่นๆ ที่แนะนํา

ผู้ร่วมให้ข้อมูล

ผู้แต่งหลัก

Teresa Qin | Google Maps วิศวกรโซลูชันแพลตฟอร์ม