Routes API เปิดตัวเป็นเวอร์ชันตัวอย่างแบบสาธารณะ (ก่อน GA) ในเดือนกันยายน 2022 ข้อเสนอก่อนเปิดให้ใช้งานทั่วไปอยู่ภายใต้ข้อกำหนดเฉพาะบริการของ Google Maps Platform ดูข้อมูลเพิ่มเติมได้ที่คำอธิบายเกี่ยวกับระยะการเปิดตัว
ส่วนนี้จะอธิบายวิธีย้ายข้อมูลแอปจากรุ่นตัวอย่างไปยังรุ่น GA
ฟีเจอร์ใหม่ที่เพิ่มลงในรุ่น GA
การเปิดตัว GA ได้เพิ่มฟีเจอร์ใหม่ต่อไปนี้ซึ่งไม่ได้รวมอยู่ใน เวอร์ชันตัวอย่าง
นอกจากรหัสสถานที่และพิกัดละติจูด/ลองจิจูดแล้ว ตอนนี้คุณยังระบุสถานที่ในรุ่น GA ได้ด้วยการใช้ข้อมูลต่อไปนี้
สตริงที่อยู่ ("ชิคาโก รัฐอิลลินอยส์" หรือ "ดาร์วิน นอร์เทิร์นเทร์ริทอรี ออสเตรเลีย")
โดยทั่วไปแล้ว สตริงที่อยู่คือวิธีที่ผู้ใช้ป้อนที่อยู่ อย่างไรก็ตาม {product_name} ต้องเข้ารหัสที่อยู่ภายในก่อนเพื่อแปลงเป็นพิกัดละติจูด/ลองจิจูดก่อนจึงจะคำนวณเส้นทางได้
นอกจากนี้ เรายังได้เพิ่มการรองรับพารามิเตอร์คำขอ
regionCode
ซึ่งช่วยให้คุณระบุให้แสดงผลลัพธ์ที่แปลงเป็นพิกัดภูมิศาสตร์สำหรับภูมิภาคที่เฉพาะเจาะจงได้-
Plus Codes เป็นเหมือนที่อยู่ของผู้คนหรือสถานที่ซึ่งไม่มีที่อยู่อย่างเป็นทางการ Plus Codes ไม่ใช่ข้อมูลที่อยู่ที่ประกอบด้วยชื่อถนนและบ้านเลขที่ แต่จะเป็นชุดตัวเลขและตัวอักษรที่สร้างขึ้นโดยอิงจากพิกัดละติจูดและลองจิจูด
ตอนนี้การตอบกลับของเส้นทางการคำนวณมีอาร์เรย์
geocodingResults
แล้ว สำหรับสถานที่ตั้งทุกแห่งในคำขอ (ต้นทาง ปลายทาง หรือจุดแวะพักกลางทาง) ที่ระบุเป็นสตริง ที่อยู่หรือเป็นโค้ด Plus 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
(การจราจรบนเส้นประกอบ)
สิ่งที่ต้องทำ
หากต้องการรับฟิลด์การตอบกลับสำหรับข้อมูลค่าผ่านทาง การสิ้นเปลืองเชื้อเพลิง หรือการจราจรใน
Polyline คุณต้องตั้งค่าฟิลด์อาร์เรย์คำขอใหม่ extraComputations
ให้
รวมค่าต่อไปนี้อย่างน้อย 1 ค่า
หากต้องการรับข้อมูลค่าผ่านทาง ให้ตั้งค่าฟิลด์อาร์เรย์ใหม่
extraComputations
เป็น"TOLLS"
หากต้องการรับการสิ้นเปลืองเชื้อเพลิง ให้ตั้งค่าฟิลด์อาร์เรย์
extraComputations
ใหม่เป็น"FUEL_CONSUMPTION"
หากต้องการรับข้อมูลการจราจรบนเส้นหลายเส้น ให้ตั้งค่า ฟิลด์อาร์เรย์
extraComputations
ใหม่เป็น"TRAFFIC_ON_POLYLINE"