หัวข้อสำคัญ

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

ขอบเขตเวลา

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

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

จุดต้นทางและการติดถนน

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

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

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

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

ทิศทางการเดินทาง (ขาเข้าเทียบกับขาออก)

คุณสามารถคำนวณความสามารถในการเข้าถึงทั้งขาเข้าและขาออกได้โดยใช้พารามิเตอร์ travelDirection ดังนี้

• FROM (ขาออก): คำนวณพื้นที่ที่เข้าถึงได้จากจุดต้นทาง ภายในเวลาที่กำหนด ซึ่งเหมาะสำหรับกรณีการใช้งาน เช่น เขตนำส่งหรือพื้นที่ให้บริการ
• TO (ขาเข้า): คำนวณพื้นที่ที่คุณสามารถเดินทางไปยังจุดต้นทางได้ภายในเวลาที่กำหนด เหมาะสำหรับ การกำหนดเขตพื้นที่บริการ เช่น สถานที่ที่พนักงานสามารถเดินทางจากที่พักมายัง สำนักงานกลาง

การรับรู้การเข้าชม

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

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

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

การปรับให้เรียบเนียนและความเที่ยงตรง

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

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

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

    

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

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

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

    

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