ผลิตภัณฑ์หรือฟีเจอร์นี้อยู่ในสถานะเดิม ดูข้อมูลเพิ่มเติมเกี่ยวกับระยะเดิมและวิธีย้ายข้อมูลจากบริการเดิมไปยังบริการที่ใหม่กว่าได้ที่ผลิตภัณฑ์และฟีเจอร์เดิม

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

คำขอและการตอบกลับของ Distance Matrix API (เดิม)

นักพัฒนาซอฟต์แวร์ในเขตเศรษฐกิจยุโรป (EEA)

บทนำ

คำขอ Distance Matrix API (เดิม) มีรูปแบบดังนี้

https://maps.googleapis.com/maps/api/distancematrix/outputFormat?parameters

โดย outputFormat อาจมีค่าใดค่าหนึ่งต่อไปนี้

json (แนะนํา) ระบุเอาต์พุตใน JavaScript Object Notation (JSON)
xml ระบุเอาต์พุตเป็น XML

พารามิเตอร์บางรายการเป็นพารามิเตอร์ที่จำเป็น ส่วนบางรายการเป็นพารามิเตอร์ที่ไม่บังคับ ตามมาตรฐานใน URL พารามิเตอร์ทั้งหมดจะคั่นด้วยเครื่องหมายแอมเพอร์แซนด์ (&) อักขระที่สงวนไว้ทั้งหมด (เช่น เครื่องหมายบวก "+") ต้องเข้ารหัส URL รายการพารามิเตอร์ และค่าที่เป็นไปได้แสดงอยู่ด้านล่าง

พารามิเตอร์ที่จำเป็น

ปลายทาง

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

จุดเริ่มต้นสำหรับการคำนวณระยะทางและเวลาในการเดินทาง คุณ ระบุสถานที่อย่างน้อย 1 แห่งโดยคั่นด้วยอักขระไปป์ (|) ในรูปแบบ รหัสสถานที่ ที่อยู่ หรือพิกัดละติจูด/ลองจิจูดได้
- รหัสสถานที่: หากระบุรหัสสถานที่ คุณต้องนำหน้าด้วย place_id:
- ที่อยู่: หากส่งที่อยู่ บริการจะเข้ารหัสพิกัดภูมิศาสตร์ สตริงและแปลงเป็นพิกัดละติจูด/ลองจิจูดเพื่อ คำนวณระยะทาง พิกัดนี้อาจแตกต่างจากพิกัดที่ Geocoding API ส่งคืน เช่น ทางเข้าอาคารแทนที่จะเป็นจุดศูนย์กลาง
  หมายเหตุ: เราขอแนะนำให้ใช้รหัสสถานที่มากกว่าใช้ที่อยู่หรือ พิกัดละติจูด/ลองจิจูด การใช้พิกัดจะส่งผลให้ ระบบปักหมุดไปยังถนนที่ใกล้กับพิกัดเหล่านั้นมากที่สุดเสมอ ซึ่งอาจไม่ใช่จุดเข้าถึงของที่พัก หรือแม้แต่ถนนที่ จะนำไปสู่จุดหมายปลายทางได้อย่างรวดเร็วหรือปลอดภัย การใช้ที่อยู่จะ ระบุระยะทางไปยังศูนย์กลางของอาคาร ไม่ใช่ ทางเข้าอาคาร
- พิกัด: หากคุณส่งพิกัดละติจูด/ลองจิจูด ระบบจะจัดพอดีกับถนนที่ใกล้ที่สุด เราขอแนะนำให้ส่งรหัสสถานที่ หากส่งพิกัด โปรดตรวจสอบว่าไม่มีการเว้นวรรค ระหว่างค่าละติจูดและลองจิจูด
- Plus Codes ต้องจัดรูปแบบเป็นรหัสสากลหรือ รหัสผสม จัดรูปแบบ Plus Codes ดังที่แสดงที่นี่ (เครื่องหมายบวกจะ หลีกเลี่ยง URL เป็น %2B และการเว้นวรรคจะหลีกเลี่ยง URL เป็น %20)
  - รหัสสากล คือรหัสพื้นที่ 4 หลักและรหัสท้องถิ่น 6 หลักขึ้นไป (849VCWC8+R9 จะได้รับการเข้ารหัสเป็น 849VCWC8%2BR9)
  - รหัสผสมคือรหัสท้องถิ่น 6 หลักขึ้นไป ที่มีการระบุตำแหน่งชัดเจน (CWC8+R9 Mountain View, CA, USA ได้รับการเข้ารหัสเป็น CWC8%2BR9%20Mountain%20View%20CA%20USA)
- เส้นประกอบที่เข้ารหัส หรือคุณจะระบุชุดพิกัดที่เข้ารหัสโดยใช้ อัลกอริทึมเส้นประกอบที่เข้ารหัสก็ได้ ซึ่งจะมีประโยชน์อย่างยิ่งหากคุณมีจุดต้นทางจำนวนมาก เนื่องจาก URL จะสั้นลงอย่างมากเมื่อใช้ Polyline ที่เข้ารหัส
  - พอลีไลน์ที่เข้ารหัสต้องขึ้นต้นด้วย enc: และตามด้วยเครื่องหมายโคลอน : เช่น origins=enc:gfo}EtohhU:
  - นอกจากนี้ คุณยังใส่ Polyline ที่เข้ารหัสได้หลายรายการโดยคั่นด้วย อักขระไปป์ | เช่น
```
origins=enc:wc~oAwquwMdlTxiKtqLyiK:|enc:c~vnAamswMvlTor@tjGi}L:|enc:udymA{~bxM:
```

พารามิเตอร์ที่ไม่บังคับ

arrival_time

ระบุเวลาที่ต้องการถึงสำหรับเส้นทางการขนส่งเป็นวินาที ตั้งแต่เที่ยงคืนของวันที่ 1 มกราคม 1970 UTC คุณระบุ departure_time หรือ arrival_time ได้อย่างใดอย่างหนึ่ง แต่จะระบุทั้ง 2 อย่างไม่ได้ โปรดทราบว่าต้องระบุ arrival_time เป็นจำนวนเต็ม
หลีกเลี่ยง

ระบบอาจคำนวณระยะทางตามข้อจำกัดบางอย่าง ข้อจํากัดจะระบุโดยใช้พารามิเตอร์หลีกเลี่ยงและอาร์กิวเมนต์ ไปยังพารามิเตอร์นั้นซึ่งระบุข้อจํากัดที่จะหลีกเลี่ยง ระบบรองรับข้อจำกัดต่อไปนี้
- tolls ระบุว่าเส้นทางที่คำนวณแล้วควรหลีกเลี่ยงถนน/สะพานที่มีค่าผ่านทาง
- highways ระบุว่าเส้นทางที่คำนวณแล้วควรหลีกเลี่ยง ทางหลวง
- ferries ระบุว่าเส้นทางที่คำนวณแล้วควรหลีกเลี่ยง เรือข้ามฟาก
- indoor ระบุว่าเส้นทางที่คำนวณแล้วควรหลีกเลี่ยง บันไดในอาคารสำหรับเส้นทางการเดินและเส้นทางขนส่งสาธารณะ
คุณขอเส้นทางที่หลีกเลี่ยงค่าผ่านทาง ทางหลวง และเรือข้ามฟากได้ โดยส่งข้อจำกัดทั้ง 2 อย่างไปยังพารามิเตอร์ "หลีกเลี่ยง" เช่น avoid=tolls|highways|ferries

หมายเหตุ: การเพิ่มข้อจำกัดไม่ได้เป็นการกีดกันเส้นทางที่มีฟีเจอร์ที่ถูกจำกัด แต่จะทำให้ผลลัพธ์เป็นเส้นทางที่เหมาะสมกว่า
departure_time

ระบุเวลาออกเดินทางที่ต้องการ คุณระบุเวลาเป็น จำนวนเต็มในหน่วยวินาทีตั้งแต่เที่ยงคืนของวันที่ 1 มกราคม 1970 (UTC) ได้ หากระบุ departure_time ที่ช้ากว่า 9999-12-31T23:59:59.999999999Z API จะเปลี่ยนกลับdeparture_timeเป็น 9999-12-31T23:59:59.999999999Z หรือจะระบุค่าเป็น now ก็ได้ ซึ่งจะตั้งเวลาออกเดินทางเป็นเวลาปัจจุบัน (ถูกต้องจนถึง วินาทีที่ใกล้ที่สุด) คุณระบุเวลาออกเดินทางได้ใน 2 กรณีต่อไปนี้
- สำหรับคำขอที่มีโหมดการเดินทางเป็นขนส่งสาธารณะ คุณสามารถระบุตัวเลือกใดตัวเลือกหนึ่งต่อไปนี้ได้ departure_time หรือ arrival_time หากไม่ได้ระบุเวลาใดเวลาหนึ่ง departure_time จะใช้ค่าเริ่มต้น เป็นเวลาปัจจุบัน (กล่าวคือ เวลาออกเดินทางจะใช้เวลาปัจจุบันเป็นค่าเริ่มต้น)
- สำหรับคำขอที่โหมดการเดินทางคือการขับรถ คุณสามารถระบุ departure_time เพื่อรับเส้นทางและระยะเวลาการเดินทาง (ฟิลด์การตอบกลับ: duration_in_traffic) ที่พิจารณาสภาพการจราจร ได้ ต้องตั้งค่า departure_time เป็นเวลาปัจจุบัน หรือเวลาในอนาคต ต้องไม่ใช่วันที่ที่ผ่านมาแล้ว
หมายเหตุ: หากไม่ได้ระบุเวลาออกเดินทาง การเลือกเส้นทางและระยะเวลาจะอิงตามเครือข่ายถนนและสภาพการจราจรโดยเฉลี่ยที่ไม่ขึ้นอยู่กับเวลา ผลลัพธ์สำหรับคำขอหนึ่งๆ อาจแตกต่างกันไปเมื่อเวลาผ่านไปเนื่องจากการเปลี่ยนแปลงในเครือข่ายถนน สภาพการจราจรโดยเฉลี่ยที่อัปเดตแล้ว และลักษณะการกระจายของบริการ นอกจากนี้ ผลลัพธ์อาจแตกต่างกันระหว่างเส้นทางที่เกือบจะเทียบเท่ากันได้ทุกเมื่อหรือทุกความถี่

หมายเหตุ: คำขอเมทริกซ์ระยะทางที่ระบุ departure_time เมื่อ mode=driving จะจำกัดไว้ที่องค์ประกอบสูงสุด 100 รายการต่อคำขอ จำนวนต้นทางคูณด้วยจำนวนปลายทางจะกำหนดจำนวน องค์ประกอบ
ภาษา

ภาษาที่จะแสดงผลลัพธ์
- ดู รายการภาษาที่รองรับ Google มักจะอัปเดตภาษาที่รองรับอยู่เสมอ ดังนั้นรายการนี้จึงอาจไม่ครอบคลุมทั้งหมด
- หากไม่ได้ระบุ language API จะพยายามใช้ภาษาที่ต้องการตามที่ระบุไว้ในส่วนหัว Accept-Language
- API จะพยายามอย่างเต็มที่เพื่อให้ที่อยู่ที่อ่านง่ายสำหรับทั้งผู้ใช้และคนในพื้นที่ เพื่อให้บรรลุเป้าหมายดังกล่าว ระบบจะแสดงที่อยู่ในภาษาท้องถิ่น โดยแปลงเป็นสคริปต์ที่ผู้ใช้อ่านได้หากจำเป็น ตามภาษาที่ต้องการ ส่วนที่อยู่อื่นๆ จะแสดงในภาษาที่ต้องการ คอมโพเนนต์ของที่อยู่ ทั้งหมดจะแสดงในภาษาเดียวกัน ซึ่งเลือกจากคอมโพเนนต์แรก
- หากชื่อไม่มีในภาษาที่ต้องการ API จะใช้ชื่อที่ใกล้เคียงที่สุด
- ภาษาที่ต้องการมีผลเล็กน้อยต่อชุดผลลัพธ์ที่ API เลือกที่จะแสดงผล และลำดับที่แสดงผล Geocoder จะตีความตัวย่อแตกต่างกันไปตามภาษา เช่น ตัวย่อของประเภทถนน หรือคำพ้องความหมายที่อาจ ใช้ได้ในภาษาหนึ่งแต่ใช้ไม่ได้ในอีกภาษาหนึ่ง เช่น utca และ tér เป็นคำพ้องความหมายของถนนในภาษาฮังการี
โหมด

คุณระบุ รูปแบบการเดินทางที่จะใช้ในการคำนวณระยะทางและเส้นทางได้ โดยค่าเริ่มต้น ระบบจะใช้โหมด DRIVING โดยค่าเริ่มต้น ระบบจะคำนวณเส้นทางเป็นเส้นทางการขับรถ ระบบรองรับ โหมดการเดินทางต่อไปนี้
- driving (ค่าเริ่มต้น) แสดงเส้นทางการขับขี่มาตรฐานหรือ ระยะทางโดยใช้เครือข่ายถนน
- walking ขอเส้นทางเดินเท้าหรือระยะทางโดยใช้ ทางเท้าและทางเดินเท้า (หากมี)
- bicycling ขอเส้นทางหรือระยะทางสำหรับจักรยานโดยใช้ เส้นทางจักรยานและถนนที่ต้องการ (หากมี)
- transit ขอเส้นทางหรือระยะทางโดยใช้เส้นทางขนส่งสาธารณะ (หากมี) หากตั้งค่าโหมดเป็นขนส่งสาธารณะ คุณจะระบุdeparture_timeหรือarrival_timeก็ได้ หากไม่ได้ระบุเวลาใดเวลาหนึ่ง departure_time จะใช้เวลาปัจจุบันเป็นค่าเริ่มต้น (กล่าวคือ เวลาออกเดินทางจะใช้เวลาปัจจุบันเป็นค่าเริ่มต้น) นอกจากนี้ คุณยังเลือกที่จะรวม transit_mode และ/หรือ transit_routing_preference ได้ด้วย
หมายเหตุ: บางครั้งทั้งเส้นทางเดินเท้าและเส้นทางจักรยานอาจไม่มี เส้นทางเดินเท้าหรือเส้นทางจักรยานที่ชัดเจน ดังนั้นเส้นทางเหล่านี้จะแสดง คำเตือนในผลลัพธ์ที่แสดง ซึ่งคุณต้องแสดงต่อผู้ใช้

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

รหัสภูมิภาคที่ระบุเป็นค่า 2 อักขระของ ccTLD ("โดเมนระดับบนสุด") รหัส ccTLD ส่วนใหญ่จะเหมือนกับรหัส ISO 3166-1 โดยมีข้อยกเว้นที่สำคัญบางประการ ตัวอย่างเช่น ccTLD ของสหราชอาณาจักรคือ "uk" (.co.uk) ขณะที่รหัส ISO 3166-1 คือ "gb" (ในทางเทคนิคสำหรับ นิติบุคคลของ "สหราชอาณาจักรบริเตนใหญ่และไอร์แลนด์เหนือ")
traffic_model

ระบุสมมติฐานที่จะใช้เมื่อคำนวณเวลาในการเข้าชม การตั้งค่านี้ จะส่งผลต่อค่าที่แสดงในฟิลด์ duration_in_traffic ใน การตอบกลับ ซึ่งมีเวลาที่คาดการณ์ในการเข้าชมตามค่าเฉลี่ยในอดีต ระบุพารามิเตอร์ traffic_model ได้เฉพาะ เส้นทางการขับรถที่คำขอมี departure_time เท่านั้น ค่าที่ใช้ได้สำหรับพารามิเตอร์นี้ ได้แก่
- best_guess (ค่าเริ่มต้น) ระบุว่า duration_in_traffic ที่แสดงควรเป็นค่าประมาณที่ดีที่สุดของระยะเวลาเดินทางโดยพิจารณาจากข้อมูลสภาพการจราจรในอดีตและสภาพการจราจรแบบเรียลไทม์ การจราจรแบบเรียลไทม์จะมีความสำคัญมากขึ้นเมื่อ departure_time ใกล้กับเวลาปัจจุบัน
- pessimistic บ่งชี้ว่า duration_in_traffic ที่แสดงผล ควรนานกว่าระยะเวลาเดินทางจริงในวันส่วนใหญ่ แม้ว่า บางวันที่มีสภาพการจราจรแย่เป็นพิเศษอาจมีค่าเกินกว่า ค่านี้
- optimistic แสดงว่า duration_in_traffic ที่แสดงผล ควรสั้นกว่าระยะเวลาเดินทางจริงในวันส่วนใหญ่ แม้ว่า บางวันที่มีสภาพการจราจรดีเป็นพิเศษอาจเร็วกว่า ค่านี้
ค่าเริ่มต้นของ best_guess จะให้การคาดการณ์ที่มีประโยชน์มากที่สุด สำหรับกรณีการใช้งานส่วนใหญ่ เป็นไปได้ที่ best_guess การคาดการณ์ระยะเวลาเดินทางอาจสั้นกว่า optimistic หรือยาวกว่า pessimistic เนื่องจากวิธีที่ best_guess โมเดลการคาดการณ์ผสานรวมข้อมูลการจราจรแบบเรียลไทม์
transit_mode

ระบุรูปแบบการขนส่งที่ต้องการอย่างน้อย 1 รูปแบบ พารามิเตอร์นี้ระบุได้เฉพาะ เส้นทางขนส่งสาธารณะเท่านั้น พารามิเตอร์รองรับอาร์กิวเมนต์ต่อไปนี้
- bus ระบุว่าเส้นทางที่คำนวณควรเลือก การเดินทางโดยรถประจำทาง
- subway ระบุว่าเส้นทางที่คำนวณแล้วควร ใช้รถไฟใต้ดิน
- train บ่งบอกว่าเส้นทางที่คำนวณควร เดินทางโดยรถไฟ
- tram แสดงว่าเส้นทางที่คำนวณควรเลือก การเดินทางด้วยรถรางและรถไฟฟ้ารางเบา
- rail ระบุว่าเส้นทางที่คำนวณควรเลือก การเดินทางโดยรถไฟ รถราง รถไฟฟ้ารางเบา และรถไฟใต้ดิน ซึ่งเทียบเท่ากับ transit_mode=train|tram|subway
transit_routing_preference

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

ระบุระบบหน่วยที่จะใช้เมื่อแสดงผลลัพธ์

หมายเหตุ: การตั้งค่าระบบหน่วยนี้มีผลกับข้อความที่แสดงใน ฟิลด์ระยะทางเท่านั้น ฟิลด์ระยะทางยังมีค่าที่แสดงเป็นเมตรเสมอ อีกด้วย

ตัวอย่างคำขอ

ตัวอย่างนี้ใช้พิกัดละติจูด/ลองจิจูดเพื่อระบุ พิกัดปลายทาง

URL

https://maps.googleapis.com/maps/api/distancematrix/json
  ?destinations=40.659569%2C-73.933783%7C40.729029%2C-73.851524%7C40.6860072%2C-73.6334271%7C40.598566%2C-73.7527626
  &origins=40.6655101%2C-73.89188969999998
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/distancematrix/json?origins=40.6655101%2C-73.89188969999998&destinations=40.659569%2C-73.933783%7C40.729029%2C-73.851524%7C40.6860072%2C-73.6334271%7C40.598566%2C-73.7527626&key=YOUR_API_KEY'

ตัวอย่างนี้ใช้ Plus Codes เพื่อระบุพิกัดปลายทาง

URL

https://maps.googleapis.com/maps/api/distancematrix/json
  ?destinations=San%20Francisco
  &origins=849VCWC8%2BR9
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/distancematrix/json?origins=849VCWC8%2BR9&destinations=San%20Francisco&key=YOUR_API_KEY'

ตัวอย่างนี้แสดงคำขอเดียวกันโดยใช้เส้นหลายส่วนที่เข้ารหัส

URL

https://maps.googleapis.com/maps/api/distancematrix/json
  ?destinations=enc%3A_kjwFjtsbMt%60EgnKcqLcaOzkGari%40naPxhVg%7CJjjb%40cqLcaOzkGari%40naPxhV%3A
  &origins=40.6655101%2C-73.89188969999998
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/distancematrix/json?origins=40.6655101%2C-73.89188969999998&destinations=enc%3A_kjwFjtsbMt%60EgnKcqLcaOzkGari%40naPxhVg%7CJjjb%40cqLcaOzkGari%40naPxhV%3A&key=YOUR_API_KEY'

ข้อมูลการจราจร

ระบบจะใช้ข้อมูลการจราจรเมื่อมีเงื่อนไขต่อไปนี้ทั้งหมด (เงื่อนไขเหล่านี้เป็นเงื่อนไขที่จำเป็นในการรับฟิลด์ duration_in_traffic ในการตอบกลับเมทริกซ์ระยะทาง)

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

คุณเลือกที่จะรวมพารามิเตอร์ traffic_model ไว้ในคำขอได้ เพื่อระบุสมมติฐานที่จะใช้เมื่อคำนวณเวลาในการเข้าชม

URL ต่อไปนี้จะเริ่มต้นคำขอเมทริกซ์ระยะทางสำหรับระยะทางในการขับรถ ระหว่างบอสตัน แมสซาชูเซตส์ หรือชาร์ลส์ทาวน์ แมสซาชูเซตส์ กับเล็กซิงตัน แมสซาชูเซตส์ และคองคอร์ด แมสซาชูเซตส์ คำขอมีเวลาออกเดินทาง ซึ่งเป็นไปตามข้อกำหนดทั้งหมดในการแสดงผลฟิลด์ duration_in_traffic ในการตอบกลับ Distance Matrix

URL

https://maps.googleapis.com/maps/api/distancematrix/json
  ?departure_time=now
  &destinations=Lexington%2CMA%7CConcord%2CMA
  &origins=Boston%2CMA%7CCharlestown%2CMA
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/distancematrix/json?origins=Boston%2CMA%7CCharlestown%2CMA&destinations=Lexington%2CMA%7CConcord%2CMA&departure_time=now&key=YOUR_API_KEY'

JSON

{
  "destination_addresses": ["Lexington, MA, USA", "Concord, MA, USA"],
  "origin_addresses": ["Boston, MA, USA", "Charlestown, Boston, MA, USA"],
  "rows":
    [
      {
        "elements":
          [
            {
              "distance": { "text": "33.3 km", "value": 33253 },
              "duration": { "text": "27 mins", "value": 1620 },
              "duration_in_traffic": { "text": "34 mins", "value": 2019 },
              "status": "OK",
            },
            {
              "distance": { "text": "41.5 km", "value": 41491 },
              "duration": { "text": "33 mins", "value": 1981 },
              "duration_in_traffic": { "text": "39 mins", "value": 2342 },
              "status": "OK",
            },
          ],
      },
      {
        "elements":
          [
            {
              "distance": { "text": "31.1 km", "value": 31100 },
              "duration": { "text": "26 mins", "value": 1543 },
              "duration_in_traffic": { "text": "29 mins", "value": 1754 },
              "status": "OK",
            },
            {
              "distance": { "text": "39.3 km", "value": 39338 },
              "duration": { "text": "32 mins", "value": 1904 },
              "duration_in_traffic": { "text": "35 mins", "value": 2077 },
              "status": "OK",
            },
          ],
      },
    ],
  "status": "OK",
}

XML


 OK
 Boston, MA, USA
 Charlestown, Boston, MA, USA
 Lexington, MA, USA
 Concord, MA, USA
 
  
   OK
   
    1620
    27 mins
   
   
    33253
    33.3 km
   
   
    2018
    34 mins
   
  
  
   OK
   
    1981
    33 mins
   
   
    41491
    41.5 km
   
   
    2342
    39 mins
   
  
 
 
  
   OK
   
    1543
    26 mins
   
   
    31100
    31.1 km
   
   
    1759
    29 mins
   
  
  
   OK
   
    1904
    32 mins
   
   
    39338
    39.3 km
   
   
    2077
    35 mins

ตัวปรับแต่งสถานที่

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

ระบุว่าเส้นทางที่คำนวณต้องผ่านถนนด้านใดด้านหนึ่ง

เมื่อระบุตำแหน่ง คุณสามารถขอให้เส้นทางที่คำนวณผ่านด้านใดด้านหนึ่งของถนนที่จุดอ้างอิงให้น้ำหนักไปทางนั้นได้โดยใช้คำนำหน้า side_of_road: เช่น คำขอนี้จะแสดงระยะทางสำหรับเส้นทางยาวเพื่อให้ยานพาหนะสิ้นสุดที่ด้านข้างของถนนซึ่งมีจุดอ้างอิงที่เอนเอียง

URL

https://maps.googleapis.com/maps/api/distancematrix/json
  ?destinations=side_of_road%3A37.7663444%2C-122.4412006
  &origins=37.7680296%2C-122.4375126
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/distancematrix/json?origins=37.7680296%2C-122.4375126&destinations=side_of_road%3A37.7663444%2C-122.4412006&key=YOUR_API_KEY'

เมื่อใช้ side_of_road: กับเส้นประกอบที่เข้ารหัส ระบบจะใช้ตัวปรับแต่งกับทุกตำแหน่งตามเส้นประกอบ เช่น ปลายทาง 2 แห่งในคำขอนี้ ใช้พารามิเตอร์เดียวกัน

URL

https://maps.googleapis.com/maps/api/distancematrix/json
  ?destinations=side_of_road%3Aenc%3A%7BoqeF%60fejV%5BnC%3A
  &origins=San%20Francisco%20City%20hall
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/distancematrix/json?origins=San%20Francisco%20City%20hall&destinations=side_of_road%3Aenc%3A%7BoqeF%60fejV%5BnC%3A&key=YOUR_API_KEY'

ตัวแก้ไข side_of_road: ใช้ได้กับการจำกัดนี้เท่านั้น

modeพารามิเตอร์การเดินทางคือ driving หรือไม่ได้ระบุ (driving คือโหมดการเดินทางเริ่มต้น)

ระบุว่าเส้นทางที่คำนวณแล้วควรมีส่วนหัวที่เฉพาะเจาะจง

เมื่อระบุสถานที่ คุณสามารถขอให้เส้นทางที่คำนวณแล้วผ่าน สถานที่นั้นๆ ในทิศทางที่เฉพาะเจาะจงได้ ส่วนหัวนี้ระบุด้วยคำนำหน้า heading=X: โดยที่ X คือค่าองศาที่เป็นจำนวนเต็มระหว่าง 0 (รวม) ถึง 360 (ไม่รวม) การมุ่งหน้า 0 หมายถึงทิศเหนือ 90 หมายถึงทิศตะวันออก และหมุนตามเข็มนาฬิกา ตัวอย่างเช่น ในคำขอนี้ เส้นทางที่คำนวณแล้วจะไปทางตะวันออก จากต้นทาง แล้วเลี้ยวกลับ

URL

https://maps.googleapis.com/maps/api/distancematrix/json
  ?destinations=37.773245%2C-122.469502
  &origins=heading%3D90%3A37.773279%2C-122.468780
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/distancematrix/json?origins=heading%3D90%3A37.773279%2C-122.468780&destinations=37.773245%2C-122.469502&key=YOUR_API_KEY'

ตัวแก้ไข heading=X: ใช้ได้เฉพาะกับข้อจำกัดต่อไปนี้

modeพารามิเตอร์การเดินทางคือ driving, bicycling หรือไม่ได้ ระบุ (driving คือโหมดการเดินทางเริ่มต้น)
ไม่ได้ระบุตัวปรับ side_of_road สำหรับสถานที่ตั้งเดียวกัน
ตำแหน่งจะระบุด้วยค่าละติจูด/ลองจิจูด คุณต้องไม่ใช้ heading กับที่อยู่ รหัสสถานที่ หรือเส้นหลายเส้นที่เข้ารหัส