หัวข้อสำคัญ

หากต้องการสร้างไอโซโครน ให้ระบุต้นทาง โหมดการเดินทาง เช่น การขับรถ การปั่นจักรยาน หรือการเดิน และระยะเวลาที่จำกัดให้กับ API นอกจากนี้ คุณยังปรับค่ากำหนดการกำหนดเส้นทางและลักษณะที่ปรากฏของรูปหลายเหลี่ยมที่ได้ได้ด้วย

ระยะเวลาที่พิจารณา

ข้อจำกัดหลักที่คุณระบุให้กับบริการคือ travel_duration ซึ่งกำหนดระยะเวลาที่พิจารณาสำหรับการคำนวณ

• ระยะเวลาสูงสุด: API รองรับระยะเวลาเดินทางสูงสุด 3,600 วินาที (1 ชั่วโมง) สำหรับโหมด DRIVE และ 7,200 วินาที (2 ชั่วโมง) สำหรับโหมด WALK และ BICYCLE
• ประสิทธิภาพ: เวลาในการคำนวณจะเพิ่มขึ้นตามระยะเวลาที่ขอและโหมดการเดินทางที่เลือก ไอโซโครนสำหรับการขับรถ 1 ชั่วโมงครอบคลุมพื้นที่ทางภูมิศาสตร์และเครือข่ายถนนที่ใหญ่กว่าไอโซโครนสำหรับการเดิน 1 ชั่วโมงอย่างมาก ซึ่งส่งผลให้คำขอการขับรถมีเวลาในการตอบสนองนานขึ้น

จุดต้นทางและการปักหมุดถนน

คุณระบุจุดเริ่มต้นของไอโซโครนได้ 2 วิธี ดังนี้

• พิกัด: คู่ละติจูดและลองจิจูด (location)
• รหัสสถานที่: ตัวระบุที่ไม่ซ้ำสำหรับสถานที่ที่เฉพาะเจาะจงใน Google Maps (place) เมื่อคุณระบุรหัสสถานที่ บริการจะใช้จุดศูนย์กลางของสถานที่นั้นเป็นจุดต้นทาง โปรดทราบว่า API คาดหวังรูปแบบชื่อทรัพยากร เช่น places/ChIJ... ดูข้อมูลเพิ่มเติมเกี่ยวกับรหัสสถานที่ได้ที่ รหัสสถานที่

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

• การปักหมุดอัจฉริยะ: บริการจะพยายามปักหมุดจุดต้นทางของคุณกับส่วนถนนที่เดินทางได้ที่ใกล้ที่สุด
• การรับรู้โหมด: ตรรกะการปักหมุดจะพิจารณา travel_mode ของคุณ หากคุณขอ DRIVE API จะละเว้นเส้นทางสำหรับคนเดินเท้าเท่านั้นและมองหาถนนที่ขับได้ที่ใกล้ที่สุด หากคุณขอ WALK API จะจัดลำดับความสำคัญของเส้นทางและทางเท้าที่เดินได้
• กรณีที่เกิดข้อผิดพลาด: หาก API ไม่พบส่วนถนนที่เหมาะสมภายในระยะ ประมาณ 100 เมตรจากจุดต้นทาง API จะแสดงข้อผิดพลาด 404 NOT_FOUND ซึ่งโดยปกติจะบ่งบอกว่าจุดนั้นอยู่ไกลจากเครือข่ายถนนมากเกินไปหรืออยู่ในพื้นที่ที่ข้อมูลแผนที่ไม่รองรับโหมดการเดินทางที่ขอ

การรับรู้การจราจร

ควบคุมวิธีที่ข้อมูลการจราจรส่งผลต่อรูปหลายเหลี่ยมที่สร้างขึ้นด้วยพารามิเตอร์ routing_preference

• TRAFFIC_UNAWARE (ค่าเริ่มต้น): ใช้ขีดจำกัดความเร็วและลำดับชั้นของถนนเพื่อสร้างรูปหลายเหลี่ยมไอโซโครน ซึ่งจะสร้างรูปร่างที่กำหนดได้ซึ่งไม่ผันผวนตามช่วงเวลาของวัน พารามิเตอร์นี้เหมาะอย่างยิ่งสำหรับการวิเคราะห์ทั่วไปหรือการวางแผนสถานการณ์พื้นฐาน
• TRAFFIC_AWARE: คำนวณไอโซโครนโดยใช้สภาพการจราจรแบบเรียลไทม์หรือแบบคาดการณ์ ณ เวลาที่ส่งคำขอ ซึ่งจะทำให้พื้นที่ที่เข้าถึงได้เล็กลงในช่วงที่มีการจราจรติดขัดและใหญ่ขึ้นในช่วงเวลาที่ไม่ใช่ช่วงเวลาเร่งด่วน

หมายเหตุ: ไอโซโครนที่รับรู้การจราจรจะมีความไวต่อเวลาในการตอบสนองมากกว่าไอโซโครนที่ไม่รับรู้การจราจร

การปรับให้เรียบและระดับความละเอียด

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

• polygon_fidelity: ควบคุมขนาดของเซลล์ตารางกริดพื้นฐานที่ใช้ในการคำนวณพื้นที่ที่เข้าถึงได้

  • LOW: ใช้เซลล์ตารางกริดขนาดใหญ่ เหมาะที่สุดสำหรับการครอบคลุมพื้นที่ขนาดใหญ่โดยไม่มีช่องว่าง ซึ่งจะทำให้ได้รูปร่างทั่วไป
  • MEDIUM: ความแม่นยำที่สมดุล
  • HIGH: ใช้เซลล์ตารางกริดขนาดเล็ก ส่งผลให้เข้ากับเครือข่ายถนนได้ดีขึ้น แต่สามารถสร้างพื้นที่ว่างหรือรูได้หากเครือข่ายถนนมีไม่หนาแน่น
  • POLYGON_FIDELITY_UNSPECIFIED: หากไม่ได้ระบุ บริการจะเลือกความละเอียดแบบไดนามิกตามระยะเวลาการเดินทางที่ขอ

    

    ความละเอียดของรูปหลายเหลี่ยมสูง ปานกลาง และต่ำ

• enable_smoothing: ควบคุมว่าจะปัดขอบคมของเซลล์ตารางกริดที่กำหนดโดยความละเอียดหรือไม่

  • false (ดิบ): ค่าเริ่มต้น แสดงผลการคำนวณทางเรขาคณิตที่แน่นอน ขอบจะปรากฏเป็นหยักหรือเป็นขั้น เหมาะที่สุดสำหรับความแม่นยำในการวิเคราะห์ เช่น การทดสอบจุดในรูปหลายเหลี่ยมที่เข้มงวด เวลาในการตอบสนองสั้นกว่าแบบปรับให้เรียบ
  • true (ปรับให้เรียบ): ใช้การอัลกอริทึมหลังการประมวลผลเพื่อปัดมุม เหมาะที่สุดสำหรับการแสดงผลแบบภาพบนแผนที่

    

    ไอโซโครนแบบปรับให้เรียบและไม่ปรับให้เรียบ