Routes API เปิดตัวเป็นเวอร์ชันตัวอย่างแบบสาธารณะ (ก่อนเวอร์ชันสำหรับผู้ใช้ทั่วไป) ในเดือนกันยายน 2022 ข้อเสนอก่อนเวอร์ชันสำหรับผู้ใช้ทั่วไปจะอยู่ภายใต้ข้อกำหนดเฉพาะบริการ Google Maps Platform ดูข้อมูลเพิ่มเติมได้ในคำอธิบายขั้นตอนการเปิดตัว
ส่วนนี้จะอธิบายวิธีย้ายข้อมูลแอปจากรุ่นตัวอย่างไปยังรุ่น GA
ฟีเจอร์ใหม่ที่เพิ่มเข้ามาในรุ่น GA
รุ่น GA ได้เพิ่มฟีเจอร์ใหม่ต่อไปนี้ซึ่งไม่ได้รวมอยู่ในตัวอย่าง
นอกจากรหัสสถานที่และพิกัดละติจูด/ลองจิจูดแล้ว คุณสามารถระบุตำแหน่งในรุ่น GA ได้โดยใช้สิ่งต่อไปนี้
สตริงที่อยู่ ("Chicago, IL" หรือ "Darwin, NT, Australia")
สตริงที่อยู่มักเป็นวิธีที่ผู้ใช้ป้อนที่อยู่ อย่างไรก็ตาม {product_name} จะต้องเข้ารหัสสตริงที่อยู่ภายในเพื่อแปลงเป็นพิกัดละติจูด/ลองจิจูดก่อนจึงจะคำนวณเส้นทางได้
นอกจากนี้ยังมีการรองรับพารามิเตอร์คำขอ
regionCode
ซึ่งช่วยให้คุณระบุการแสดงผลการค้นหาที่ระบุพิกัดทางภูมิศาสตร์สำหรับภูมิภาคทางภูมิศาสตร์ที่ต้องการได้-
Plus Codes เป็นเหมือนที่อยู่ของผู้คนหรือสถานที่ที่ไม่มีที่อยู่จริง Plus Codes ไม่ใช่ที่อยู่ที่ประกอบด้วยชื่อถนนและตัวเลข เพราะจะใช้ข้อมูลละติจูดและลองจิจูด แล้วแสดงเป็นตัวเลขและตัวอักษร
ตอนนี้การตอบกลับของเส้นทางการประมวลผลมีอาร์เรย์
geocodingResults
แล้ว สําหรับทุกสถานที่ตั้งในคำขอ (ต้นทาง ปลายทาง หรือจุดอ้างอิงระหว่างกลาง) ที่ได้รับการระบุเป็นสตริงที่อยู่หรือเป็น Plus Code API จะดำเนินการค้นหารหัสสถานที่ องค์ประกอบแต่ละรายการของอาร์เรย์นี้ประกอบด้วยรหัสสถานที่ที่สอดคล้องกับตำแหน่ง พร้อมกับข้อมูลเมตาเพิ่มเติมเกี่ยวกับตำแหน่ง ระบบจะไม่สนใจตำแหน่งในคำขอที่ระบุเป็นรหัสสถานที่หรือพิกัดละติจูด/ลองจิจูด
การเปลี่ยนแปลงฟีเจอร์เวอร์ชันตัวอย่างที่มีอยู่
ตอนนี้คุณต้องเปิดใช้ฟีเจอร์ต่อไปนี้ใน GA อย่างชัดแจ้งด้วยการเพิ่มช่องอาร์เรย์ extraComputations
ใหม่ในคำขอ
ในรุ่นตัวอย่าง คุณใช้มาสก์ช่องเพื่อระบุเพื่อแสดงข้อมูลสำหรับฟีเจอร์เหล่านี้ในคำตอบ ในขั้นตอนนี้ คุณจะต้องดำเนินการ 2 อย่างต่อไปนี้
- ตั้งค่าพารามิเตอร์คำขออาร์เรย์
extraComputations
ใหม่เพื่อเปิดใช้ฟีเจอร์เหล่านี้ - กำหนดมาสก์ของช่องเพื่อระบุเพื่อแสดงข้อมูลในคำตอบ
สิ่งที่คุณต้องทราบ
ช่องต่อไปนี้จะไม่รวมอยู่ในการตอบกลับของcomputeRouteMatrix อีกต่อไป เว้นแต่ว่าจะมีการเปิดใช้อย่างชัดแจ้งในการตั้งค่า extraComputations
travelAdvisory.tollInfo
(ข้อมูลค่าผ่านทาง)
ช่องต่อไปนี้จะไม่รวมอยู่ในการตอบกลับของ ComputeRoutes อีกต่อไป เว้นแต่จะเปิดใช้อย่างชัดแจ้งในการตั้งค่า extraComputations
routes.legs.travelAdvisory.tollInfo
(ข้อมูลค่าผ่านทาง)routes.travelAdvisory.tollInfo
(ข้อมูลค่าผ่านทาง)routes.travelAdvisory.fuelConsumptionMicroliters
(ปริมาณการใช้เชื้อเพลิง)routes.travelAdvisory.speedReadingIntervals
(การจราจรบนเส้นประกอบ)routes.legs.travelAdvisory.speedReadingIntervals
(การจราจรบนเส้นประกอบ)
สิ่งที่ต้องทำ
หากต้องการรับช่องคำตอบสำหรับข้อมูลค่าผ่านทาง การใช้เชื้อเพลิง หรือการจราจรของข้อมูลบนโพลีไลน์ คุณต้องตั้งค่าช่องอาร์เรย์คำขอใหม่ extraComputations
ให้รวมค่าต่อไปนี้อย่างน้อย 1 ค่า
หากต้องการรับข้อมูลค่าผ่านทาง ให้ตั้งค่าช่องอาร์เรย์
extraComputations
ใหม่เป็น"TOLLS"
หากต้องการรับปริมาณการใช้เชื้อเพลิง ให้ตั้งช่องอาร์เรย์
extraComputations
ใหม่เป็น"FUEL_CONSUMPTION"
หากต้องการรับข้อมูลการจราจรบนเส้นประกอบ ให้ตั้งค่าช่องอาร์เรย์
extraComputations
ใหม่เป็น"TRAFFIC_ON_POLYLINE"