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

ในโลกที่รับรู้ตำแหน่งได้ในปัจจุบัน ผู้ใช้คาดหวังว่าจะเข้าถึงข้อมูลสถานที่ เส้นทาง และการนำทางได้อย่างราบรื่น ไม่ว่าจะผ่านแอปรับส่งข้อความ แอปค้นหาบริบทในพื้นที่ แพลตฟอร์มโลจิสติกส์และการขนส่ง แพลนเนอร์การเดินทาง หรือ แพลตฟอร์มข้อมูลอสังหาริมทรัพย์ ผู้ใช้มักต้องการดูรายละเอียดสถานที่อย่างรวดเร็ว หรือค้นหาเส้นทางที่ดีที่สุดจากจุด ก ไปยังจุด ข แม้ว่านักพัฒนาแอปจะสร้างประสบการณ์การใช้งานในแอปของตนเองได้ แต่การใช้ประโยชน์จากอินเทอร์เฟซที่ครอบคลุมและคุ้นเคยของ 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: การค้นหาข้อความ(รหัสเท่านั้น) นี่เป็นวิธีที่ไม่มีค่าใช้จ่ายในการรับรหัสสถานที่ ดูข้อมูลเพิ่มเติมเกี่ยวกับรหัสสถานที่และคำขอ 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 การค้นหาโดยใช้รูปแบบที่แนะนำต่อไปนี้รูปแบบใดรูปแบบหนึ่งเพื่อให้ผู้ใช้ไปยังหน้ารายละเอียดสถานที่ที่ถูกต้อง

  • 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อยู่ไกลจากตำแหน่งปัจจุบันของผู้ใช้
  • 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