นำผู้ใช้ไปยังรายละเอียดและเส้นทางของสถานที่ใน 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 ซึ่งใช้งานได้ฟรี และไม่ต้องใช้คีย์ โซลูชันต่อไปนี้ใช้ได้กับสถานการณ์และกรณีการใช้งานที่แตกต่างกัน

Places API ของ GMP(ใหม่) จะแสดงชุดข้อมูลที่ครอบคลุมเกี่ยวกับสถานที่หนึ่งๆ เมื่อขอฟิลด์ googleMapsUri หรือ googleMapsLinks (โดยการระบุในField Mask) การตอบกลับของ 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: Text Search(ID Only) นี่เป็นวิธีที่ไม่มีค่าใช้จ่ายในการรับรหัสสถานที่ ดูข้อมูลเพิ่มเติมเกี่ยวกับรหัสสถานที่และคำขอ 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 จะเหมือนกันไม่ว่าแพลตฟอร์มที่ใช้จะเป็นอะไรก็ตาม คุณไม่จำเป็นต้องมีคีย์ API ของ Google เพื่อใช้ URL ของ Maps

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

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

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

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

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

เราจะมาดูฟังก์ชันการทำงานหลัก 2 อย่างของ URL ของ Maps กัน

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

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

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

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

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

โครงสร้าง URL ของการค้นหา

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 หา Place ID ไม่พบ

สถานการณ์ที่ 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 จุดขึ้นไป บนแผนที่ รวมถึงระยะทางและเวลาเดินทาง ซึ่งช่วยให้นักพัฒนาแอปควบคุมเส้นทางที่ระบุได้มากขึ้น เอกสารประกอบ GMP's Maps URLs Directions มีวิธีการโดยละเอียด ในการสร้าง 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 Web และ/หรือระหว่างจุดหมายทั้งหมด ในกรณีดังกล่าว ระบบจะ ไม่สนใจพารามิเตอร์นี้

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

สรุป

การสร้าง 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 Platform