Package google.maps.routeoptimization.v1

int32

จำนวนการจัดส่งที่ดำเนินการ โปรดทราบว่าการรับและการนำส่งจะนับเพียงครั้งเดียว

Duration

ระยะเวลาการเดินทางทั้งหมดสำหรับเส้นทางหรือโซลูชัน

Duration

ระยะเวลารอทั้งหมดสำหรับเส้นทางหรือโซลูชัน

Duration

ระยะเวลาความล่าช้าทั้งหมดของเส้นทางหรือโซลูชัน

Duration

ระยะเวลาพักทั้งหมดสำหรับเส้นทางหรือโซลูชัน

Duration

ระยะเวลาการเข้าชมทั้งหมดของเส้นทางหรือโซลูชัน

Duration

ระยะเวลาทั้งหมดควรเท่ากับผลรวมของระยะเวลาทั้งหมดข้างต้น สำหรับเส้นทาง จะสอดคล้องกับสิ่งต่อไปนี้ด้วย

[ShipmentRoute.vehicle_end_time][google.maps.routeoptimization.v1.ShipmentRoute.vehicle_end_time] - [ShipmentRoute.vehicle_start_time][google.maps.routeoptimization.v1.ShipmentRoute.vehicle_start_time]

double

ระยะทางรวมของการเดินทางสำหรับเส้นทางหรือโซลูชัน

map<string, VehicleLoad>

โหลดสูงสุดที่ทำได้ตลอดเส้นทาง (หรือโซลูชัน) สำหรับปริมาณแต่ละรายการในเส้นทาง (หรือโซลูชัน) นี้ ซึ่งคำนวณเป็นค่าสูงสุดของTransition.vehicle_loadsทั้งหมด (หรือ ShipmentRoute.metrics.max_loads.

int32

จำนวนการจัดส่งที่บังคับที่ดำเนินการ

ทดลอง: ลักษณะการทำงานหรือการมีอยู่ของฟิลด์นี้อาจมีการเปลี่ยนแปลงในอนาคต

double

ผลรวมของ Shipment.penalty_cost ของการจัดส่งที่ดำเนินการ

ทดลอง: ลักษณะการทำงานหรือการมีอยู่ของฟิลด์นี้อาจมีการเปลี่ยนแปลงในอนาคต

string

ต้องระบุ โปรเจ็กต์และตำแหน่งเป้าหมายที่จะทำการเรียก

รูปแบบ:

• projects/{project-id}
• projects/{project-id}/locations/{location-id}

หากไม่ได้ระบุสถานที่ตั้ง ระบบจะเลือกภูมิภาคโดยอัตโนมัติ

AsyncModelConfig

ต้องระบุ ข้อมูลอินพุต/เอาต์พุตของแต่ละโมเดลการซื้อ เช่น เส้นทางไฟล์และรูปแบบข้อมูล

string

ไม่บังคับ ชื่อโมเดลที่ผู้ใช้กำหนด ซึ่งผู้ใช้สามารถใช้เป็นชื่อแทนเพื่อติดตามโมเดลได้

InputConfig

ต้องระบุ ข้อมูลเกี่ยวกับโมเดลอินพุต

OutputConfig

ต้องระบุ ข้อมูลตำแหน่งเอาต์พุตที่ต้องการ

BreakRequest

ลำดับการหยุดพัก ดูข้อความBreakRequest

FrequencyConstraint

อาจมี FrequencyConstraint หลายรายการ โดยต้องเป็นไปตามข้อกำหนดทั้งหมดภายในวันที่ BreakRequest ของBreakRuleนี้ ดูข้อมูลที่ FrequencyConstraint

Timestamp

ต้องระบุ ขอบเขตล่าง (รวม) ของจุดเริ่มต้นของช่วงพัก

Timestamp

ต้องระบุ ขอบเขตบน (รวม) ของเวลาเริ่มต้นของช่วงพัก

Duration

ต้องระบุ ระยะเวลาขั้นต่ำของช่วงพัก ต้องเป็นค่าบวก

Duration

ต้องระบุ ระยะเวลาขั้นต่ำของช่วงพักสำหรับข้อจำกัดนี้ ไม่เป็นลบ ดูคำอธิบายของ FrequencyConstraint

Duration

ต้องระบุ ช่วงเวลาสูงสุดที่อนุญาตในเส้นทางซึ่งไม่มีช่วงพักของ duration >= min_break_duration อย่างน้อยบางส่วน ต้องเป็นค่าบวก

int64

ขีดจำกัดที่กำหนดระยะทางสูงสุดเป็น max_meters ขีดจำกัดต้องไม่ติดลบ

int64

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

หากกำหนด soft_max_meters ต้องน้อยกว่า max_meters และต้องไม่เป็นค่าลบ

double

ต้นทุนต่อกิโลเมตรที่เกิดขึ้น โดยเพิ่มขึ้นสูงสุด soft_max_meters ด้วยสูตรต่อไปนี้

  min(distance_meters, soft_max_meters) / 1000.0 *
  cost_per_kilometer_below_soft_max.

route_distance_limit ไม่รองรับต้นทุนนี้

double

ค่าใช้จ่ายต่อกิโลเมตรที่เกิดขึ้นหากระยะทางสูงกว่าขีดจำกัด soft_max_meters ค่าใช้จ่ายเพิ่มเติมจะเป็น 0 หากระยะทางต่ำกว่าขีดจำกัด ไม่เช่นนั้นสูตรที่ใช้ในการคำนวณค่าใช้จ่ายจะเป็นดังนี้

  (distance_meters - soft_max_meters) / 1000.0 *
  cost_per_kilometer_above_soft_max.

ค่าใช้จ่ายต้องไม่ติดลบ

string

ต้องระบุ URI ของ Google Cloud Storage

string

ต้องระบุ URI ของออบเจ็กต์ Google Cloud Storage ที่มีรูปแบบ gs://bucket/path/to/object

ShipmentRoute

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

SkippedShipment

การข้ามการจัดส่งโซลูชันที่จะแทรก และอาจไม่มีในโซลูชันเดิม ดูฟิลด์ routes

ConstraintRelaxation

สำหรับกลุ่มยานพาหนะตั้งแต่ 0 กลุ่มขึ้นไป ให้ระบุเวลาและจำนวนที่จะผ่อนปรนข้อจำกัด หากช่องนี้ว่างเปล่า เส้นทางยานพาหนะทั้งหมดที่ไม่ว่างจะถูกจำกัดอย่างเต็มที่

Relaxation

การผ่อนปรนข้อจำกัดการเข้าชมทั้งหมดที่จะมีผลกับการเข้าชมในเส้นทางที่มีรถยนต์ใน vehicle_indices

int32

ระบุดัชนียานพาหนะที่ข้อจำกัดการเข้าชม relaxations มีผล หากเว้นว่างไว้ ระบบจะถือว่านี่คือค่าเริ่มต้น และ relaxations จะมีผลกับยานพาหนะทั้งหมดที่ไม่ได้ระบุไว้ใน constraint_relaxations อื่นๆ มีค่าเริ่มต้นได้สูงสุด 1 รายการ กล่าวคือ อนุญาตให้ฟิลด์การผ่อนปรนข้อจำกัดว่างได้สูงสุด 1 รายการ vehicle_indices ดัชนียานพาหนะจะแสดงได้เพียงครั้งเดียว แม้จะอยู่ใน constraint_relaxations หลายรายการก็ตาม

ระบบจะแมปดัชนียานพาหนะเช่นเดียวกับ ShipmentRoute.vehicle_index หาก interpret_injected_solutions_using_labels เป็นจริง (ดูความคิดเห็น fields)

Level

ระดับการผ่อนปรนข้อจำกัดที่ใช้เมื่อตรงตามเงื่อนไขที่หรือหลังจาก threshold_time และอย่างน้อย threshold_visit_count

Timestamp

เวลาที่อาจใช้การผ่อนปรน level

int32

จำนวนการเข้าชมที่หรือหลังจากนั้นอาจมีการใช้การผ่อนปรน level หาก threshold_visit_count เป็น 0 (หรือไม่ได้ตั้งค่า) ระบบอาจใช้ level เมื่อยานพาหนะเริ่มทำงานโดยตรง

หากเป็น route.visits_size() + 1 คุณจะใช้ level ได้ที่ปลายทางของยานพาหนะเท่านั้น หากมีค่ามากกว่า route.visits_size() + 1 ระบบจะไม่ใช้ level กับเส้นทางนั้นเลย

DataFormat

ต้องระบุ รูปแบบข้อมูลอินพุต

GcsSource

ตำแหน่งของ Google Cloud Storage โดยต้องเป็นออบเจ็กต์ (ไฟล์) เดียว

LatLng

พิกัดทางภูมิศาสตร์ของจุดอ้างอิง

int32

เข็มทิศที่เชื่อมโยงกับทิศทางการไหลของการเข้าชม ค่านี้ใช้เพื่อระบุฝั่งของถนนที่จะใช้สำหรับการรับและส่ง ค่า Heading จะมีตั้งแต่ 0 ถึง 360 โดย 0 หมายถึงทิศเหนือ 90 หมายถึงทิศตะวันออก เป็นต้น

string

ต้องระบุ โปรเจ็กต์หรือสถานที่เป้าหมายที่จะโทร

รูปแบบ:

• projects/{project-id}
• projects/{project-id}/locations/{location-id}

หากไม่ได้ระบุสถานที่ตั้ง ระบบจะเลือกภูมิภาคโดยอัตโนมัติ

Duration

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

สำหรับคำขอแบบไม่พร้อมกัน เซิร์ฟเวอร์จะสร้างโซลูชัน (หากเป็นไปได้) ก่อนที่การหมดเวลาจะผ่านไป

ShipmentModel

รูปแบบการจัดส่งที่ต้องการแก้ไข

SolvingMode

โดยค่าเริ่มต้น โหมดการแก้ปัญหาคือ DEFAULT_SOLVE (0)

SearchMode

โหมดการค้นหาที่ใช้ในการแก้ปัญหาคำขอ

ShipmentRoute

แนะนําอัลกอริทึมการเพิ่มประสิทธิภาพในการค้นหาโซลูชันแรกที่คล้ายกับโซลูชันก่อนหน้า

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

โซลูชันต้องเป็นไปตามสมมติฐานความถูกต้องพื้นฐานบางประการ ดังนี้

• สำหรับเส้นทางทั้งหมด vehicle_index ต้องอยู่ในช่วงและไม่ซ้ำกัน
• สําหรับการเข้าชมทั้งหมด shipment_index และ visit_request_index ต้องอยู่ในช่วง
• การอ้างอิงการจัดส่งจะทำได้ในเส้นทางเดียวเท่านั้น
• การรับสินค้าของการจัดส่งแบบรับและนำส่งต้องดำเนินการก่อนการนำส่ง
• การรับสินค้าหรือการนำส่งสินค้าทางเลือกจะดำเนินการได้ไม่เกิน 1 รายการ
• สำหรับเส้นทางทั้งหมด เวลาจะเพิ่มขึ้น (เช่น vehicle_start_time <= visits[0].start_time <= visits[1].start_time ... <= vehicle_end_time)
• การจัดส่งจะดำเนินการได้เฉพาะในยานพาหนะที่ได้รับอนุญาตเท่านั้น อนุญาตให้ใช้ยานพาหนะได้หาก Shipment.allowed_vehicle_indices ว่างเปล่าหรือมี vehicle_index อยู่ใน Shipment.allowed_vehicle_indices

หากโซลูชันที่แทรกไม่สามารถใช้งานได้ ระบบอาจไม่แสดงข้อผิดพลาดในการตรวจสอบ แต่จะแสดงข้อผิดพลาดที่ระบุว่าใช้งานไม่ได้แทน

InjectedSolutionConstraint

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

หากโซลูชันที่แทรกไม่สามารถใช้งานได้ ระบบอาจไม่แสดงข้อผิดพลาดในการตรวจสอบ แต่จะแสดงข้อผิดพลาดที่ระบุว่าใช้งานไม่ได้แทน

ShipmentRoute

หากไม่ว่างเปล่า ระบบจะรีเฟรชเส้นทางที่ระบุโดยไม่แก้ไขลำดับการเข้าชมหรือเวลาเดินทางพื้นฐาน มีเพียงรายละเอียดอื่นๆ เท่านั้นที่จะได้รับการอัปเดต การดำเนินการนี้จะไม่แก้ปัญหาโมเดล

ตั้งแต่เดือนพฤศจิกายน 2020 เป็นต้นมา ฟีเจอร์นี้จะแสดงเฉพาะเส้นหลายเหลี่ยมของเส้นทางที่มีข้อมูล และกำหนดให้ populate_polylines เป็นจริง

ฟิลด์ route_polyline ของเส้นทางที่ส่งเข้ามาอาจไม่สอดคล้องกับเส้นทาง transitions

ห้ามใช้ฟิลด์นี้ร่วมกับ injected_first_solution_routes หรือ injected_solution_constraint

Shipment.ignore และ Vehicle.ignore จะไม่มีผลต่อลักษณะการทำงาน ระบบจะยังคงสร้างเส้นหลายเส้นระหว่างการเข้าชมทั้งหมดในเส้นทางทั้งหมดที่ไม่ว่างเปล่า ไม่ว่าระบบจะเพิกเฉยต่อการจัดส่งหรือยานพาหนะที่เกี่ยวข้องหรือไม่ก็ตาม

bool

หากเป็นจริง

• ใช้ ShipmentRoute.vehicle_label แทน vehicle_index เพื่อจับคู่เส้นทางในโซลูชันที่แทรกกับยานพาหนะในคำขอ ใช้การแมป ShipmentRoute.vehicle_index เดิมกับ ShipmentRoute.vehicle_index ใหม่เพื่ออัปเดต ConstraintRelaxation.vehicle_indices หากมีค่า แต่การแมปต้องไม่คลุมเครือ (กล่าวคือ ShipmentRoute หลายรายการต้องไม่ใช้ vehicle_index เดิมเดียวกัน)
• ใช้ ShipmentRoute.Visit.shipment_label แทน shipment_index เพื่อจับคู่การเข้าชมในโซลูชันที่แทรกกับการจัดส่งในคำขอ
• ใช้ SkippedShipment.label แทน SkippedShipment.index เพื่อจับคู่การจัดส่งที่ข้ามในโซลูชันที่แทรกกับการจัดส่งที่ขอ

การตีความนี้มีผลกับช่อง injected_first_solution_routes, injected_solution_constraint และ refresh_details_routes ใช้ได้เมื่อดัชนีการจัดส่งหรือยานพาหนะในคำขอมีการเปลี่ยนแปลงนับตั้งแต่สร้างโซลูชันขึ้นมา ซึ่งอาจเป็นเพราะมีการนำการจัดส่งหรือยานพาหนะออกจากคำขอหรือเพิ่มลงในคำขอ

หากเป็นจริง ค่ายเพลงในหมวดหมู่ต่อไปนี้ต้องปรากฏในหมวดหมู่ของตนเองอย่างมาก 1 ครั้ง

• Vehicle.label ในคำขอ
• Shipment.label ในคำขอ
• ShipmentRoute.vehicle_label ในสารละลายที่ฉีด
• SkippedShipment.label และ ShipmentRoute.Visit.shipment_label ในโซลูชันที่แทรก (ยกเว้นคู่การเข้าชมการรับ/นำส่ง ซึ่ง shipment_label ต้องปรากฏ 2 ครั้ง)

หาก vehicle_label ในโซลูชันที่แทรกไม่สอดคล้องกับยานพาหนะที่ขอ ระบบจะนำเส้นทางที่เกี่ยวข้องออกจากโซลูชันพร้อมกับการเข้าชม หาก shipment_label ในโซลูชันที่แทรกไม่สอดคล้องกับการจัดส่งที่ขอ ระบบจะนำการเข้าชมที่เกี่ยวข้องออกจากโซลูชัน หาก SkippedShipment.label ในโซลูชันที่แทรกไม่สอดคล้องกับการจัดส่งที่ขอ ระบบจะนำ SkippedShipment ออกจากโซลูชัน

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

หมายเหตุ: ผู้โทรต้องตรวจสอบว่าแต่ละ Vehicle.label (resp. Shipment.label) ระบุเอนทิตีของยานพาหนะ (การจัดส่ง) ที่ใช้ในคำขอที่เกี่ยวข้อง 2 รายการอย่างไม่ซ้ำกัน ได้แก่ คำขอก่อนหน้าที่สร้าง OptimizeToursResponse ที่ใช้ในโซลูชันที่แทรก และคำขอปัจจุบันที่มีโซลูชันที่แทรก การตรวจสอบความไม่ซ้ำกันที่อธิบายไว้ข้างต้นไม่เพียงพอที่จะรับประกันข้อกำหนดนี้

bool

พิจารณาการประมาณการการเข้าชมในการคำนวณฟิลด์ ShipmentRoute Transition.travel_duration, Visit.start_time และ vehicle_end_time ในการตั้งค่าฟิลด์ ShipmentRoute.has_traffic_infeasibilities และในการคำนวณฟิลด์ OptimizeToursResponse.total_cost

bool

หากเป็นจริง ระบบจะแสดงเส้นหลายเส้นในคำตอบ ShipmentRoute

bool

หากเป็นจริง ระบบจะป้อนข้อมูลเส้นหลายเส้นและโทเค็นเส้นทางในการตอบกลับ ShipmentRoute.transitions

bool

หากตั้งค่านี้ไว้ คำขอจะมีกำหนดเวลาได้สูงสุด 60 นาที (ดู https://grpc.io/blog/deadlines) ไม่เช่นนั้น กำหนดเวลาสูงสุดจะอยู่ที่ 30 นาทีเท่านั้น โปรดทราบว่าคำขอที่ใช้งานเป็นเวลานานมีความเสี่ยงที่จะถูกขัดจังหวะสูงกว่าอย่างมาก (แต่ก็ยังถือว่าน้อย)

bool

หากเป็นจริง ระบบจะคำนวณระยะทางการเดินทางโดยใช้ระยะทาง Geodesic แทนระยะทางของ Google Maps และจะคำนวณเวลาเดินทางโดยใช้ระยะทาง Geodesic ที่มีความเร็วซึ่งกำหนดโดย geodesic_meters_per_second

string

ป้ายกำกับที่อาจใช้เพื่อระบุคำขอนี้ ซึ่งจะรายงานกลับใน OptimizeToursResponse.request_label

double

เมื่อ use_geodesic_distances เป็นจริง คุณต้องตั้งค่าฟิลด์นี้และกำหนดความเร็วที่ใช้ในการคำนวณเวลาในการเดินทาง ค่าต้องไม่ต่ำกว่า 1.0 เมตร/วินาที

int32

ตัดทอนจำนวนข้อผิดพลาดในการตรวจสอบที่แสดง โดยปกติแล้ว ข้อผิดพลาดเหล่านี้จะแนบไปกับเพย์โหลดข้อผิดพลาด INVALID_ARGUMENT เป็นรายละเอียดข้อผิดพลาด BadRequest (https://cloud.google.com/apis/design/errors#error_details) เว้นแต่ solving_mode=VALIDATE_ONLY โปรดดูช่อง OptimizeToursResponse.validation_errors ค่าเริ่มต้นคือ 100 และจำกัดไว้ที่ 10,000

ShipmentRoute

เส้นทางที่คำนวณสำหรับยานพาหนะแต่ละคัน โดยเส้นทางที่ i จะสอดคล้องกับยานพาหนะที่ i ในโมเดล

string

สำเนาของ OptimizeToursRequest.label หากมีการระบุป้ายกำกับในคำขอ

SkippedShipment

รายการการจัดส่งทั้งหมดที่ข้าม

OptimizeToursValidationError

รายการข้อผิดพลาดในการตรวจสอบทั้งหมดที่เราตรวจพบได้โดยอิสระ ดูคำอธิบาย "ข้อผิดพลาดหลายรายการ" สำหรับข้อความ OptimizeToursValidationError แทนที่จะเป็นข้อผิดพลาด ระบบจะรวมคำเตือนไว้ในกรณีที่ solving_mode เป็น DEFAULT_SOLVE

OptimizeToursRequest

ในบางกรณี เราจะแก้ไขคำขอที่เข้ามา ก่อนที่จะแก้ปัญหา เช่น การเพิ่มค่าใช้จ่าย หาก solving_mode == TRANSFORM_AND_RETURN_REQUEST ระบบจะแสดงคำขอที่แก้ไขแล้วที่นี่

ทดลอง: ดูรายละเอียดเพิ่มเติมได้ที่ https://developers.google.com/maps/tt/route-optimization/experimental/objectives/make-request

Metrics

เมตริกความทนทาน ระยะทาง และการใช้งานสำหรับโซลูชันนี้

AggregatedMetrics

รวบรวมจากเส้นทาง เมตริกแต่ละรายการคือผลรวม (หรือค่าสูงสุดสำหรับการโหลด) ของฟิลด์ ShipmentRoute.metrics ทั้งหมดที่มีชื่อเดียวกัน

int32

จำนวนการจัดส่งที่บังคับซึ่งถูกข้าม

int32

จำนวนยานพาหนะที่ใช้ หมายเหตุ: หากเส้นทางของยานพาหนะว่างเปล่าและ Vehicle.used_if_route_is_empty เป็นจริง ระบบจะถือว่ายานพาหนะเป็นยานพาหนะมือสอง

Timestamp

เวลาเริ่มต้นที่เร็วที่สุดสำหรับยานพาหนะมือสอง ซึ่งคำนวณเป็นค่าต่ำสุดของยานพาหนะมือสองทั้งหมดที่ ShipmentRoute.vehicle_start_time

Timestamp

เวลาสิ้นสุดล่าสุดสำหรับยานพาหนะมือสอง ซึ่งคำนวณเป็นค่าสูงสุดของยานพาหนะมือสองทั้งหมดของ ShipmentRoute.vehicle_end_time

map<string, double>

ต้นทุนของโซลูชันที่แยกย่อยตามช่องคำขอที่เกี่ยวข้องกับต้นทุน คีย์คือเส้นทาง Proto ที่สัมพันธ์กับ OptimizeToursRequest อินพุต เช่น "model.shipments.pickups.cost" และค่าคือต้นทุนทั้งหมดที่สร้างขึ้นโดยฟิลด์ต้นทุนที่เกี่ยวข้อง ซึ่งรวบรวมไว้ในโซลูชันทั้งหมด กล่าวคือ costs["model.shipments.pickups.cost"] คือผลรวมของต้นทุนการรับสินค้าทั้งหมดในโซลูชัน ต้นทุนทั้งหมดที่กําหนดไว้ในโมเดลจะรายงานอย่างละเอียดที่นี่ ยกเว้นต้นทุนที่เกี่ยวข้องกับ TransitionAttributes ซึ่งจะรายงานในลักษณะรวมเท่านั้น ณ วันที่ 01/2022

double

ต้นทุนรวมของโซลูชัน ผลรวมของค่าทั้งหมดในแผนที่ต้นทุน

string

ต้องระบุ โปรเจ็กต์หรือสถานที่เป้าหมายที่จะโทร

รูปแบบ:

• projects/{project-id}
• projects/{project-id}/locations/{location-id}

หากไม่ได้ระบุสถานที่ตั้ง ระบบจะเลือกภูมิภาคโดยอัตโนมัติ

Uri

ต้องระบุ URI ของออบเจ็กต์ Cloud Storage ที่มี OptimizeToursRequest

Uri

ต้องระบุ URI ของออบเจ็กต์ Cloud Storage ที่จะมี OptimizeToursResponse

Uri

ไม่บังคับ URI ของออบเจ็กต์ Cloud Storage ที่มี OptimizeToursResponse ซึ่งเข้ารหัสเป็น JSON หรือ Textproto หากเข้ารหัสออบเจ็กต์เป็น JSON นามสกุลของชื่อออบเจ็กต์จะเป็น .json หากเข้ารหัสออบเจ็กต์เป็น Textproto ส่วนขยายของชื่อออบเจ็กต์จะเป็น .txtpb

คุณใช้ crc32_checksum ของทรัพยากรเพื่อยืนยันว่าเนื้อหาของทรัพยากรไม่ได้ถูกแก้ไข

int32

ข้อผิดพลาดในการตรวจสอบความถูกต้องจะกำหนดโดยคู่ (code, display_name) ซึ่งมีอยู่เสมอ

ฟิลด์หลังจากส่วนนี้จะให้บริบทเพิ่มเติมเกี่ยวกับข้อผิดพลาด

ข้อผิดพลาดหลายรายการ: เมื่อมีข้อผิดพลาดหลายรายการ กระบวนการตรวจสอบจะพยายามแสดงข้อผิดพลาดหลายรายการ กระบวนการนี้ไม่สมบูรณ์แบบเช่นเดียวกับคอมไพเลอร์ ข้อผิดพลาดในการตรวจสอบบางอย่างจะเป็น "ร้ายแรง" ซึ่งหมายความว่าข้อผิดพลาดดังกล่าวจะหยุดกระบวนการตรวจสอบทั้งหมด ซึ่งรวมถึงข้อผิดพลาด display_name="UNSPECIFIED" และอื่นๆ ข้อผิดพลาดบางอย่างอาจทำให้กระบวนการตรวจสอบข้ามข้อผิดพลาดอื่นๆ

ความเสถียร: code และ display_name ควรมีความเสถียรสูง แต่รหัสและชื่อที่แสดงใหม่ๆ อาจปรากฏขึ้นเมื่อเวลาผ่านไป ซึ่งอาจทำให้คำขอที่ระบุ (ไม่ถูกต้อง) แสดงคู่ (code, display_name) ที่แตกต่างกัน เนื่องจากข้อผิดพลาดใหม่ซ่อนข้อผิดพลาดเก่า เช่น ดู "ข้อผิดพลาดหลายรายการ"

string

ชื่อที่แสดงของข้อผิดพลาด

FieldReference

บริบทของข้อผิดพลาดอาจเกี่ยวข้องกับฟิลด์ 0, 1 (ส่วนใหญ่) หรือมากกว่า เช่น การอ้างอิงการรับสินค้าครั้งแรกของยานพาหนะ #4 และการจัดส่ง #2 สามารถทำได้ดังนี้

fields { name: "vehicles" index: 4}
fields { name: "shipments" index: 2 sub_field {name: "pickups" index: 0} }

อย่างไรก็ตาม โปรดทราบว่าคาร์ดินาลิตีของ fields ไม่ควรเปลี่ยนแปลงสำหรับรหัสข้อผิดพลาดที่กำหนด

string

สตริงที่มนุษย์อ่านได้ซึ่งอธิบายถึงข้อผิดพลาด code และ error_message มีการแมปแบบ 1:1 (เมื่อรหัส != "UNSPECIFIED")

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

string

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

string

ชื่อฟิลด์ เช่น "vehicles"

FieldReference

ฟิลด์ย่อยที่ซ้อนกันแบบเรียกซ้ำ หากจำเป็น

int32

ดัชนีของฟิลด์หากซ้ำ

string

คีย์หากฟิลด์เป็นแผนที่

DataFormat

ต้องระบุ รูปแบบข้อมูลเอาต์พุต

GcsDestination

ตำแหน่งของ Google Cloud Storage ที่จะเขียนเอาต์พุต

bool

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

bool

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

bool

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

bool

ไม่บังคับ ระบุว่าจะหลีกเลี่ยงการนำทางในอาคารเมื่อเป็นไปได้หรือไม่ ระบบจะให้ความสำคัญกับเส้นทางที่ไม่มีการนำทางในอาคาร ใช้กับโหมดการเดินทาง WALKING เท่านั้น

string

ชื่อที่แสดงของการจัดส่งที่ผู้ใช้กำหนด มีความยาวได้สูงสุด 63 อักขระและอาจใช้อักขระ UTF-8

VisitRequest

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

VisitRequest

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

map<string, Load>

ความต้องการในการบรรทุกของการจัดส่ง (เช่น น้ำหนัก ปริมาตร จำนวนพาเล็ต ฯลฯ) คีย์ในแผนที่ควรเป็นตัวระบุที่อธิบายประเภทของโหลดที่เกี่ยวข้อง และควรมีหน่วยด้วย เช่น "weight_kg", "volume_gallons", "pallet_count" เป็นต้น หากคีย์ที่ระบุไม่ปรากฏในแผนที่ ระบบจะถือว่าการโหลดที่เกี่ยวข้องเป็นค่าว่าง

int32

ชุดยานพาหนะที่อาจทำการจัดส่งนี้ หากเว้นว่างไว้ รถทุกคันจะดำเนินการนี้ได้ ยานพาหนะจะระบุตามดัชนีในรายการShipmentModelของvehicles

double

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

• มีจำนวนองค์ประกอบเท่ากับ costs_per_vehicle_indices costs_per_vehicle[i] สอดคล้องกับยานพาหนะ costs_per_vehicle_indices[i] ของโมเดล
• จำนวนองค์ประกอบเท่ากับจำนวนยานพาหนะในโมเดล องค์ประกอบที่ i สอดคล้องกับยานพาหนะ #i ของโมเดล

ต้นทุนเหล่านี้ต้องอยู่ในหน่วยเดียวกันกับ penalty_cost และต้องไม่ติดลบ ปล่อยช่องนี้ว่างไว้หากไม่มีค่าใช้จ่ายดังกล่าว

int32

ดัชนีของยานพาหนะที่ costs_per_vehicle ใช้ หากไม่ว่างเปล่า จะต้องมีจำนวนองค์ประกอบเท่ากับ costs_per_vehicle ระบุดัชนียานพาหนะมากกว่า 1 ครั้งไม่ได้ หากไม่รวมยานพาหนะจาก costs_per_vehicle_indices ค่าใช้จ่ายของยานพาหนะจะเป็น 0

Duration

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

ตัวอย่างเช่น ให้ t เป็นเวลาที่สั้นที่สุดในการเดินทางจากทางเลือกในการรับสินค้าที่เลือกไปยังทางเลือกในการนำส่งที่เลือกโดยตรง จากนั้นการตั้งค่า pickup_to_delivery_absolute_detour_limit จะบังคับใช้สิ่งต่อไปนี้

start_time(delivery) - start_time(pickup) <=
t + pickup_to_delivery_absolute_detour_limit

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

Duration

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

string

สตริงที่ไม่ว่างเปล่าซึ่งระบุ "ประเภท" สำหรับการจัดส่งนี้ ฟีเจอร์นี้ใช้เพื่อกำหนดความเข้ากันไม่ได้หรือข้อกำหนดระหว่าง shipment_types ได้ (ดู shipment_type_incompatibilities และ shipment_type_requirements ใน ShipmentModel)

แตกต่างจาก visit_types ซึ่งระบุไว้สำหรับการเข้าชมครั้งเดียว: การรับ/นำส่งทั้งหมดที่อยู่ในการจัดส่งเดียวกันจะใช้ shipment_type เดียวกัน

string

ระบุป้ายกำกับการจัดส่งนี้ ระบบจะรายงานป้ายกำกับนี้ในการตอบกลับใน shipment_label ของ ShipmentRoute.Visit ที่เกี่ยวข้อง

bool

หากเป็นจริง ให้ข้ามการจัดส่งนี้ แต่ไม่ต้องใช้ penalty_cost

การไม่สนใจการจัดส่งจะทำให้เกิดข้อผิดพลาดในการตรวจสอบเมื่อมี shipment_type_requirements ในโมเดล

ระบบอนุญาตให้ละเว้นการจัดส่งที่ดำเนินการใน injected_first_solution_routes หรือ injected_solution_constraint ได้ โดยตัวแก้จะนำการเข้าชมการรับ/นำส่งที่เกี่ยวข้องออกจากเส้นทางที่ดำเนินการ precedence_rules ที่อ้างอิงการจัดส่งที่ระบบไม่สนใจก็จะไม่มีผลเช่นกัน

double

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

สำคัญ: หากไม่ได้ระบุค่าปรับนี้ ระบบจะถือว่าไม่มีที่สิ้นสุด นั่นคือต้องดำเนินการจัดส่งให้เสร็จสมบูรณ์

double

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

ตัวอย่างเช่น ให้ t เป็นเวลาที่สั้นที่สุดในการเดินทางจากทางเลือกในการรับสินค้าที่เลือกไปยังทางเลือกในการนำส่งที่เลือกโดยตรง จากนั้นการตั้งค่า pickup_to_delivery_relative_detour_limit จะบังคับใช้สิ่งต่อไปนี้

start_time(delivery) - start_time(pickup) <=
std::ceil(t * (1.0 + pickup_to_delivery_relative_detour_limit))

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

int64

ปริมาณการโหลดของยานพาหนะที่ทำการเข้าชมที่เกี่ยวข้องจะแตกต่างกัน เนื่องจากเป็นจำนวนเต็ม เราขอแนะนำให้ผู้ใช้เลือกหน่วยที่เหมาะสมเพื่อหลีกเลี่ยงการสูญเสียความแม่นยำ ต้อง ≥ 0

LatLng

ตำแหน่งทางภูมิศาสตร์ที่ยานพาหนะมาถึงเมื่อดำเนินการ VisitRequest นี้ หากรูปแบบการจัดส่งมีเมทริกซ์ระยะทางและระยะเวลา arrival_location ต้องไม่ระบุ

Waypoint

จุดอ้างอิงที่ยานพาหนะจะไปถึงเมื่อทำ VisitRequest นี้ หากรูปแบบการจัดส่งมีเมทริกซ์ระยะทางและระยะเวลา arrival_waypoint ต้องไม่ระบุ

LatLng

ตำแหน่งทางภูมิศาสตร์ที่ยานพาหนะออกเดินทางหลังจากทำVisitRequestนี้เสร็จ จะเว้นไว้ก็ได้หากเหมือนกับ arrival_location หากรูปแบบการจัดส่งมีเมทริกซ์ระยะทางและระยะเวลา departure_location ต้องไม่ระบุ

Waypoint

จุดอ้างอิงที่ยานพาหนะออกเดินทางหลังจากทำVisitRequestนี้เสร็จ จะเว้นไว้ก็ได้หากเหมือนกับ arrival_waypoint หากรูปแบบการจัดส่งมีเมทริกซ์ระยะทางและระยะเวลา departure_waypoint ต้องไม่ระบุ

string

ระบุแท็กที่แนบมากับคำขอเข้าชม ไม่อนุญาตให้ใช้สตริงที่ว่างเปล่าหรือซ้ำกัน

TimeWindow

กรอบเวลาที่จำกัดเวลามาถึงในการเข้าชม โปรดทราบว่ายานพาหนะอาจออกเดินทางนอกกรอบเวลาการมาถึง กล่าวคือ เวลามาถึง + ระยะเวลาไม่จำเป็นต้องอยู่ภายในกรอบเวลา ซึ่งอาจทำให้ต้องรอหากยานพาหนะมาถึงก่อน TimeWindow.start_time

การไม่มี TimeWindow หมายความว่ายานพาหนะสามารถทำการเยี่ยมชมนี้ได้ทุกเมื่อ

กรอบเวลาต้องไม่ทับซ้อนกัน กล่าวคือ กรอบเวลาต้องไม่ทับซ้อนหรืออยู่ติดกับกรอบเวลาอื่น และต้องเรียงตามลำดับจากน้อยไปมาก

คุณจะตั้งค่า cost_per_hour_after_soft_end_time และ soft_end_time ได้ก็ต่อเมื่อมีกรอบเวลาเดียวเท่านั้น

Duration

ระยะเวลาการเข้าชม เช่น เวลาที่ยานพาหนะใช้ระหว่างการมาถึงและการออกเดินทาง (จะเพิ่มลงในเวลาที่อาจต้องรอ ดู time_windows)

double

ค่าใช้จ่ายในการให้บริการคำขอการเข้าชมนี้ในเส้นทางของยานพาหนะ ซึ่งสามารถใช้ชำระค่าใช้จ่ายที่แตกต่างกันสำหรับการรับหรือนำส่งพัสดุแต่ละรายการได้ ต้นทุนนี้ต้องอยู่ในหน่วยเดียวกับ Shipment.penalty_cost และต้องไม่เป็นค่าลบ

map<string, Load>

โหลดความต้องการของคำขอการเข้าชมนี้ ซึ่งจะเหมือนกับฟิลด์ Shipment.load_demands เพียงแต่จะมีผลกับ VisitRequest นี้เท่านั้น ไม่ใช่ทั้ง Shipment ความต้องการที่ระบุไว้ที่นี่จะเพิ่มลงในความต้องการที่ระบุไว้ใน Shipment.load_demands

string

ระบุประเภทการเข้าชม ซึ่งอาจใช้เพื่อจัดสรรเวลาเพิ่มเติมที่จำเป็นสำหรับยานพาหนะในการเข้าชมนี้ให้เสร็จสมบูรณ์ (ดู Vehicle.extra_visit_duration_for_visit_type)

ประเภทจะปรากฏได้เพียงครั้งเดียว

string

ระบุป้ายกำกับสำหรับ VisitRequest นี้ ป้ายกำกับนี้จะรายงานในคำตอบเป็น visit_label ใน ShipmentRoute.Visit ที่เกี่ยวข้อง

bool

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

ทดลอง: ดูรายละเอียดเพิ่มเติมได้ที่ https://developers.google.com/maps/tt/route-optimization/experimental/u-turn-avoidance/make-request

Shipment

ชุดการจัดส่งที่ต้องดำเนินการในโมเดล

Vehicle

ชุดยานพาหนะที่ใช้ในการเข้าชมได้

Objective

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

ทดลอง: ดูรายละเอียดเพิ่มเติมได้ที่ https://developers.google.com/maps/tt/route-optimization/experimental/objectives/make-request

Timestamp

เวลาเริ่มต้นและสิ้นสุดทั่วโลกของโมเดล: ระบบจะไม่พิจารณาเวลาที่อยู่นอกช่วงนี้ว่าถูกต้อง

ช่วงเวลาของโมเดลต้องน้อยกว่า 1 ปี กล่าวคือ global_end_time และ global_start_time ต้องอยู่ภายใน 31536000 วินาที

เมื่อใช้ฟิลด์ cost_per_*hour คุณอาจต้องการตั้งค่าช่วงเวลานี้ให้มีช่วงเวลาที่สั้นลงเพื่อเพิ่มประสิทธิภาพ (เช่น หากคุณสร้างแบบจำลองวันเดียว คุณควรตั้งค่าขีดจำกัดเวลาทั่วโลกเป็นวันนั้น) หากไม่ได้ตั้งค่า ระบบจะใช้ 00:00:00 UTC, 1 มกราคม 1970 (เช่น วินาที: 0, นาโน: 0) เป็นค่าเริ่มต้น

Timestamp

หากไม่ได้ตั้งค่า ระบบจะใช้ 00:00:00 UTC, 1 มกราคม 1971 (เช่น วินาที: 31536000, นาโน: 0) เป็นค่าเริ่มต้น

double

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

DurationDistanceMatrix

ระบุเมทริกซ์ระยะเวลาและระยะทางที่ใช้ในโมเดล หากช่องนี้ว่างเปล่า ระบบจะใช้ Google Maps หรือระยะทางทางภูมิศาสตร์แทน ทั้งนี้ขึ้นอยู่กับค่าของช่อง use_geodesic_distances หากไม่ได้เว้นว่างไว้ use_geodesic_distances จะเป็นจริงไม่ได้ และทั้ง duration_distance_matrix_src_tags และ duration_distance_matrix_dst_tags จะเว้นว่างไว้ไม่ได้

ตัวอย่างการใช้งาน

• มี 2 สถานที่ ได้แก่ locA และ locB
• ยานพาหนะ 1 คันเริ่มเส้นทางที่ locA และสิ้นสุดที่ locA
• คำขอการเข้าชมเพื่อรับสินค้า 1 รายการที่ locB

model {
  vehicles { start_tags: "locA"  end_tags: "locA" }
  shipments { pickups { tags: "locB" } }
  duration_distance_matrix_src_tags: "locA"
  duration_distance_matrix_src_tags: "locB"
  duration_distance_matrix_dst_tags: "locA"
  duration_distance_matrix_dst_tags: "locB"
  duration_distance_matrices {
    rows {  # from: locA
      durations { seconds: 0 }   meters: 0    # to: locA
      durations { seconds: 100 } meters: 1000 # to: locB
    }
    rows {  # from: locB
      durations { seconds: 102 } meters: 990 # to: locA
      durations { seconds: 0 }   meters: 0   # to: locB
    }
  }
}

• โดยมีสถานที่ 3 แห่ง ได้แก่ locA, locB และ locC
• รถ 1 คันเริ่มเส้นทางที่ locA และสิ้นสุดที่ locB โดยใช้เมทริกซ์ "เร็ว"
• รถ 1 คันเริ่มเส้นทางที่ locB และสิ้นสุดที่ locB โดยใช้เมทริกซ์ "ช้า"
• ยานพาหนะ 1 คันเริ่มเส้นทางที่ locB และสิ้นสุดที่ locB โดยใช้เมทริกซ์ "fast"
• คำขอเข้าชมเพื่อรับสินค้า 1 รายการที่ locC

model {
  vehicles { start_tags: "locA" end_tags: "locB" start_tags: "fast" }
  vehicles { start_tags: "locB" end_tags: "locB" start_tags: "slow" }
  vehicles { start_tags: "locB" end_tags: "locB" start_tags: "fast" }
  shipments { pickups { tags: "locC" } }
  duration_distance_matrix_src_tags: "locA"
  duration_distance_matrix_src_tags: "locB"
  duration_distance_matrix_src_tags: "locC"
  duration_distance_matrix_dst_tags: "locB"
  duration_distance_matrix_dst_tags: "locC"
  duration_distance_matrices {
    vehicle_start_tag: "fast"
    rows {  # from: locA
      durations { seconds: 1000 } meters: 2000 # to: locB
      durations { seconds: 600 }  meters: 1000 # to: locC
    }
    rows {  # from: locB
      durations { seconds: 0 }   meters: 0    # to: locB
      durations { seconds: 700 } meters: 1200 # to: locC
    }
    rows {  # from: locC
      durations { seconds: 702 } meters: 1190 # to: locB
      durations { seconds: 0 }   meters: 0    # to: locC
    }
  }
  duration_distance_matrices {
    vehicle_start_tag: "slow"
    rows {  # from: locA
      durations { seconds: 1800 } meters: 2001 # to: locB
      durations { seconds: 900 }  meters: 1002 # to: locC
    }
    rows {  # from: locB
      durations { seconds: 0 }    meters: 0    # to: locB
      durations { seconds: 1000 } meters: 1202 # to: locC
    }
    rows {  # from: locC
      durations { seconds: 1001 } meters: 1195 # to: locB
      durations { seconds: 0 }    meters: 0    # to: locC
    }
  }
}

string

แท็กที่กำหนดแหล่งที่มาของเมทริกซ์ระยะเวลาและระยะทาง duration_distance_matrices(i).rows(j) กำหนดระยะเวลาและระยะทางจากการเข้าชมที่มีแท็ก duration_distance_matrix_src_tags(j) ไปยังการเข้าชมอื่นๆ ในเมทริกซ์ i

แท็กตรงกับ VisitRequest.tags หรือ Vehicle.start_tags VisitRequest หรือ Vehicle ที่ระบุจะต้องตรงกับแท็ก 1 รายการในช่องนี้ โปรดทราบว่าแท็กต้นทาง ปลายทาง และเมทริกซ์ของ Vehicle อาจเหมือนกัน ในทำนองเดียวกัน แท็กต้นทางและปลายทางของ VisitRequest อาจเหมือนกัน แท็กทั้งหมดต้องแตกต่างกันและต้องไม่ใช่สตริงว่าง หากช่องนี้ไม่ว่าง duration_distance_matrices ต้องไม่ว่าง

string

แท็กที่กำหนดปลายทางของเมทริกซ์ระยะเวลาและระยะทาง duration_distance_matrices(i).rows(j).durations(k) (ตามลำดับ duration_distance_matrices(i).rows(j).meters(k)) กำหนดระยะเวลา (หรือระยะทาง) ของการเดินทางจากการเข้าชมที่มีแท็ก duration_distance_matrix_src_tags(j) ไปยังการเข้าชมที่มีแท็ก duration_distance_matrix_dst_tags(k) ในเมทริกซ์ i

แท็กตรงกับ VisitRequest.tags หรือ Vehicle.start_tags VisitRequest หรือ Vehicle ที่ระบุจะต้องตรงกับแท็ก 1 รายการในช่องนี้ โปรดทราบว่าแท็กต้นทาง ปลายทาง และเมทริกซ์ของ Vehicle อาจเหมือนกัน ในทำนองเดียวกัน แท็กต้นทางและปลายทางของ VisitRequest อาจเหมือนกัน แท็กทั้งหมดต้องแตกต่างกันและต้องไม่ใช่สตริงว่าง หากช่องนี้ไม่ว่าง duration_distance_matrices ต้องไม่ว่าง

TransitionAttributes

เพิ่มแอตทริบิวต์การเปลี่ยนฉากลงในโมเดล

ShipmentTypeIncompatibility

ชุด shipment_types ที่เข้ากันไม่ได้ (ดู ShipmentTypeIncompatibility)

ShipmentTypeRequirement

ชุดshipment_typeข้อกำหนด (ดูShipmentTypeRequirement)

PrecedenceRule

ชุดกฎลำดับความสำคัญที่ต้องบังคับใช้ในโมเดล

สำคัญ: การใช้กฎลำดับความสำคัญจะจำกัดขนาดของปัญหาที่สามารถเพิ่มประสิทธิภาพได้ คำขอที่ใช้กฎลำดับความสำคัญซึ่งมีการจัดส่งหลายรายการอาจถูกปฏิเสธ

int32

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

Row

ระบุแถวของเมทริกซ์ระยะเวลาและระยะทาง ต้องมีองค์ประกอบเท่ากับ ShipmentModel.duration_distance_matrix_src_tags

string

แท็กที่กำหนดว่าเมทริกซ์ระยะเวลาและระยะทางนี้ใช้กับยานพาหนะใด หากเว้นว่างไว้ จะมีผลกับยานพาหนะทั้งหมด และจะมีได้เพียงเมทริกซ์เดียว

การเริ่มต้นของยานพาหนะแต่ละครั้งต้องตรงกับเมทริกซ์ 1 รายการเท่านั้น กล่าวคือ ฟิลด์ start_tags ของยานพาหนะต้องตรงกับ vehicle_start_tag ของเมทริกซ์ (และของเมทริกซ์นั้นเท่านั้น)

เมทริกซ์ทั้งหมดต้องมี vehicle_start_tag ที่แตกต่างกัน

Duration

ค่าระยะเวลาสำหรับแถวที่ระบุ ต้องมีองค์ประกอบเท่ากับ ShipmentModel.duration_distance_matrix_dst_tags

double

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

Type

ประเภทของวัตถุประสงค์

double

ควรให้ความสำคัญกับวัตถุประสงค์นี้มากน้อยเพียงใดเมื่อเทียบกับวัตถุประสงค์อื่นๆ ซึ่งอาจเป็นจำนวนใดๆ ก็ได้ที่ไม่ติดลบ โดยน้ำหนักไม่จำเป็นต้องรวมกันเป็น 1 ค่าเริ่มต้นของน้ำหนักคือ 1.0

bool

ระบุว่าเหตุการณ์ "แรก" เป็นการนำส่งหรือไม่

bool

ระบุว่าเหตุการณ์ "ที่ 2" เป็นการนำส่งหรือไม่

Duration

ออฟเซ็ตระหว่างเหตุการณ์ "แรก" กับเหตุการณ์ "ที่สอง" ซึ่งอาจเป็นค่าลบได้

int32

ดัชนีการจัดส่งของเหตุการณ์ "แรก" ต้องระบุข้อมูลในช่องนี้

int32

ดัชนีการจัดส่งของเหตุการณ์ "ที่ 2" ต้องระบุข้อมูลในช่องนี้

int32

ยานพาหนะที่วิ่งตามเส้นทาง โดยระบุด้วยดัชนีในแหล่งที่มา ShipmentModel

string

ป้ายกำกับของยานพาหนะที่ใช้เส้นทางนี้ ซึ่งเท่ากับ ShipmentModel.vehicles(vehicle_index).label หากมีการระบุ

Timestamp

เวลาที่ยานพาหนะเริ่มเส้นทาง

Timestamp

เวลาที่รถสิ้นสุดเส้นทาง

Visit

ลําดับการเข้าชมที่เรียงตามลําดับซึ่งแสดงเส้นทาง visits[i] คือการเข้าชมครั้งที่ i ในเส้นทาง หากช่องนี้ว่างเปล่า ระบบจะถือว่ารถไม่ได้ใช้งาน

Transition

รายการการเปลี่ยนเส้นทางที่เรียงลำดับแล้วสำหรับเส้นทาง

bool

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

  start_time(previous_visit) + duration(previous_visit) +
  travel_duration(previous_visit, next_visit) > start_time(next_visit)

การมาถึงที่ next_visit มีแนวโน้มที่จะเกิดขึ้นช้ากว่ากรอบเวลาปัจจุบันเนื่องจากเวลาเดินทางโดยประมาณเพิ่มขึ้น travel_duration(previous_visit, next_visit) อันเนื่องมาจากปริมาณการเข้าชม นอกจากนี้ ระบบอาจบังคับให้ช่วงพักซ้อนทับกับการเข้าชมเนื่องจากเวลาเดินทางโดยประมาณเพิ่มขึ้นและข้อจำกัดของกรอบเวลาการเข้าชมหรือช่วงพัก

EncodedPolyline

การแสดงเส้นประกอบที่เข้ารหัสของเส้นทาง ระบบจะป้อนข้อมูลในช่องนี้ก็ต่อเมื่อตั้งค่า OptimizeToursRequest.populate_polylines เป็น "จริง"

Break

เวลาพักที่กำหนดไว้สำหรับยานพาหนะที่วิ่งในเส้นทางนี้ breaks ลำดับแสดงช่วงเวลา โดยแต่ละช่วงจะเริ่มต้นที่ start_time ที่เกี่ยวข้องและมีระยะเวลา duration วินาที

AggregatedMetrics

เมตริกระยะเวลา ระยะทาง และภาระงานสำหรับเส้นทางนี้ ระบบจะรวมฟิลด์ของ AggregatedMetrics ใน ShipmentRoute.transitions หรือ ShipmentRoute.visits ทั้งหมด โดยขึ้นอยู่กับบริบท

VehicleFullness

VehicleFullness เพื่อคำนวณว่าเมตริกที่จำกัดนั้นใกล้เคียงกับขีดจำกัดของยานพาหนะที่เกี่ยวข้องมากน้อยเพียงใด ฟิลด์ของเมตริกนี้คืออัตราส่วนระหว่างฟิลด์เมตริกที่มีการจำกัด (เช่น AggregatedMetrics.travel_distance_meters) กับขีดจำกัดของยานพาหนะที่เกี่ยวข้อง (เช่น Vehicle.route_distance_limit)

ทดลอง: ลักษณะการทำงานหรือการมีอยู่ของฟิลด์นี้อาจมีการเปลี่ยนแปลงในอนาคต

map<string, double>

ต้นทุนของเส้นทางที่แยกย่อยตามช่องคำขอที่เกี่ยวข้องกับต้นทุน คีย์คือเส้นทาง Proto ที่สัมพันธ์กับ OptimizeToursRequest ที่ป้อน เช่น "model.shipments.pickups.cost" และค่าคือต้นทุนทั้งหมดที่สร้างขึ้นโดยฟิลด์ต้นทุนที่เกี่ยวข้อง ซึ่งรวบรวมไว้ในเส้นทางทั้งหมด กล่าวคือ costs["model.shipments.pickups.cost"] คือผลรวมของต้นทุนการรับสินค้าทั้งหมดในเส้นทาง ต้นทุนทั้งหมดที่กําหนดไว้ในโมเดลจะรายงานอย่างละเอียดที่นี่ ยกเว้นต้นทุนที่เกี่ยวข้องกับ TransitionAttributes ซึ่งจะรายงานในลักษณะรวมเท่านั้น ณ วันที่ 01/2022

double

ต้นทุนรวมของเส้นทาง ผลรวมของค่าใช้จ่ายทั้งหมดในแผนที่ต้นทุน

Timestamp

เวลาเริ่มต้นของช่วงพัก

Duration

ระยะเวลาของช่วงพัก

string

สตริงที่แสดงจุดที่เข้ารหัสของเส้นหลายเส้น

Duration

ระยะเวลาการเดินทางในช่วงเปลี่ยนผ่านนี้

double

ระยะทางที่เดินทางระหว่างการเปลี่ยน

bool

เมื่อมีการขอการเข้าชมผ่าน OptimizeToursRequest.consider_road_traffic และดึงข้อมูลการเข้าชมสำหรับ Transition ไม่ได้ ระบบจะตั้งค่าบูลีนนี้เป็นจริง ปัญหานี้อาจเป็นปัญหาชั่วคราว (ข้อผิดพลาดที่เกิดขึ้นไม่บ่อยนักในเซิร์ฟเวอร์การจราจรแบบเรียลไทม์) หรือปัญหาถาวร (ไม่มีข้อมูลสำหรับตำแหน่งนี้)

Duration

ผลรวมของระยะเวลาการหน่วงเวลาที่ใช้กับการเปลี่ยนฉากนี้ หากมี การหน่วงเวลาจะเริ่มขึ้นตรงกับ delay_duration วินาทีก่อนเหตุการณ์ถัดไป (การเข้าชมหรือการสิ้นสุดของยานพาหนะ) ดู TransitionAttributes.delay

Duration

ผลรวมของระยะเวลาการหยุดพักที่เกิดขึ้นระหว่างการเปลี่ยนนี้ หากมี รายละเอียดเกี่ยวกับเวลาเริ่มต้นและระยะเวลาของแต่ละช่วงพักจะจัดเก็บไว้ใน ShipmentRoute.breaks

Duration

เวลาที่ใช้ในการรอระหว่างการเปลี่ยนผ่านนี้ ระยะเวลารอจะสอดคล้องกับเวลาว่างและไม่รวมเวลาพัก โปรดทราบว่าเวลารอสายนี้อาจแบ่งออกเป็นช่วงเวลาที่ไม่ต่อเนื่องกันหลายช่วง

Duration

ระยะเวลาทั้งหมดของการเปลี่ยนผ่านเพื่อความสะดวก ซึ่งเท่ากับ

• การเข้าชมครั้งถัดไป start_time (หรือ vehicle_end_time หากเป็นการเปลี่ยนเส้นทางสุดท้าย) - start_time ของการเปลี่ยนเส้นทางนี้
• หาก ShipmentRoute.has_traffic_infeasibilities เป็นเท็จ จะมีข้อกำหนดเพิ่มเติมดังนี้ `total_duration = travel_duration + delay_duration
• break_duration + wait_duration`

Timestamp

เวลาเริ่มต้นของการเปลี่ยนผ่านนี้

EncodedPolyline

การแสดงเส้นประกอบที่เข้ารหัสของเส้นทางที่ใช้ในระหว่างการเปลี่ยน ระบบจะป้อนข้อมูลในช่องนี้ก็ต่อเมื่อตั้งค่า populate_transition_polylines เป็น "จริง"

string

เอาต์พุตเท่านั้น โทเค็นแบบทึบแสงที่ส่งไปยัง Navigation SDK เพื่อสร้างเส้นทางใหม่ในระหว่างการนำทาง และในกรณีที่มีการเปลี่ยนเส้นทาง ให้ดำเนินการตามความตั้งใจเดิมเมื่อสร้างเส้นทาง ถือว่าโทเค็นนี้เป็น Blob ที่คลุมเครือ อย่าเปรียบเทียบค่าในคำขอต่างๆ เนื่องจากค่าอาจเปลี่ยนแปลงได้แม้ว่าบริการจะแสดงเส้นทางเดียวกันก็ตาม ระบบจะป้อนข้อมูลในช่องนี้ก็ต่อเมื่อตั้งค่า populate_transition_polylines เป็น "จริง"

map<string, VehicleLoad>

น้ำหนักบรรทุกของยานพาหนะในช่วงการเปลี่ยนผ่านนี้ สำหรับยานพาหนะแต่ละประเภทที่ปรากฏในVehicle.load_limitsของยานพาหนะนี้ หรือมีShipment.load_demandsที่ไม่ใช่ 0 ในการจัดส่งบางรายการที่ดำเนินการในเส้นทางนี้

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

int64

ปริมาณสัมภาระในยานพาหนะสำหรับประเภทที่ระบุ โดยปกติแล้ว หน่วยของภาระงานจะระบุตามประเภท ดูTransition.vehicle_loads

int32

ดัชนีของฟิลด์ shipments ในแหล่งข้อมูล ShipmentModel

bool

หากเป็นจริง การเข้าชมจะสอดคล้องกับการรับ Shipment ไม่เช่นนั้นจะสอดคล้องกับการนำส่ง

int32

ดัชนีของ VisitRequest ในช่องการรับสินค้าหรือการนำส่งของ Shipment (ดู is_pickup)

Timestamp

เวลาที่การเข้าชมเริ่มต้น โปรดทราบว่ายานพาหนะอาจมาถึงสถานที่นัดหมายก่อนเวลาที่ระบุไว้ เวลาเป็นไปตาม ShipmentModel

map<string, Load>

ดีมานด์การโหลดการเข้าชมทั้งหมดเป็นผลรวมของการจัดส่งและคำขอเข้าชม load_demands ค่าจะเป็นลบหากการเข้าชมเป็นการนำส่ง ระบบจะรายงานดีมานด์สำหรับประเภทเดียวกันกับ Transition.loads (ดูฟิลด์นี้)

Duration

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

start_time(delivery) - start_time(pickup)
- (duration(pickup) + travel duration from the pickup location
to the delivery location).

มิฉะนั้น ระบบจะคำนวณจากstart_locationของยานพาหนะและมีค่าเท่ากับ

start_time - vehicle_start_time - travel duration from
the vehicle's `start_location` to the visit.

string

สำเนาของ Shipment.label ที่เกี่ยวข้อง หากระบุไว้ใน Shipment

string

สำเนาของ VisitRequest.label ที่เกี่ยวข้อง หากระบุไว้ใน VisitRequest

int32

โทเค็นทึบแสงที่แสดงข้อมูลเกี่ยวกับสถานที่ที่เข้าชม

ระบบอาจป้อนข้อมูลในช่องนี้ในการเข้าชมเส้นทางผลลัพธ์เมื่อตั้งค่า VisitRequest.avoid_u_turns เป็นจริงสำหรับการเข้าชมนี้ หรือหากตั้งค่า ShipmentModel.avoid_u_turns เป็นจริงในคำขอ OptimizeToursRequest

ทดลอง: ดูรายละเอียดเพิ่มเติมได้ที่ https://developers.google.com/maps/tt/route-optimization/experimental/u-turn-avoidance/make-request

string

รายการประเภทที่ใช้ร่วมกันไม่ได้ การจัดส่ง 2 รายการที่มี shipment_types แตกต่างกันในรายการที่ระบุถือว่า "เข้ากันไม่ได้"

IncompatibilityMode

โหมดที่ใช้กับความไม่เข้ากัน

string

รายการประเภทการจัดส่งทางเลือกที่dependent_shipment_typesกำหนด

string

การจัดส่งทั้งหมดที่มีประเภทในฟิลด์ dependent_shipment_types ต้องมีการจัดส่งประเภท required_shipment_type_alternatives อย่างน้อย 1 รายการในเส้นทางเดียวกัน

หมายเหตุ: ไม่อนุญาตให้มีเชนของข้อกำหนดที่ shipment_type ขึ้นอยู่กับตัวเอง

RequirementMode

โหมดที่ใช้กับข้อกำหนด

int32

ดัชนีจะสอดคล้องกับดัชนีของการจัดส่งในแหล่งที่มา ShipmentModel

string

สำเนาของ Shipment.label ที่เกี่ยวข้อง หากระบุไว้ใน Shipment

Reason

รายการเหตุผลที่อธิบายว่าทำไมจึงข้ามการจัดส่ง ดูความคิดเห็นด้านบน Reason หากเราไม่เข้าใจว่าเหตุใดจึงข้ามการจัดส่ง ระบบจะไม่ตั้งค่าเหตุผล

double

นี่คือสำเนาของShipment.penalty_cost ซึ่งรวมไว้ที่นี่เพื่อให้ดูความรุนแรงของการจัดส่งที่ข้ามได้ง่ายขึ้น

ทดลอง: ลักษณะการทำงานหรือการมีอยู่ของฟิลด์นี้อาจมีการเปลี่ยนแปลงในอนาคต

double

อัตราส่วนโดยประมาณของยานพาหนะที่ไม่สามารถทำการจัดส่งนี้ได้เนื่องจากเหตุผลอย่างน้อย 1 ข้อด้านล่าง หมายเหตุ: จะกรอกข้อมูลนี้ก็ต่อเมื่อเหตุผลเกี่ยวข้องกับยานพาหนะเท่านั้น

ทดลอง: ลักษณะการทำงานหรือการมีอยู่ของฟิลด์นี้อาจมีการเปลี่ยนแปลงในอนาคต

Code

ดูความคิดเห็นของโค้ด

int32

เช่นเดียวกับ example_vehicle_index เว้นแต่ว่าเราจะแสดงรายการยานพาหนะหลายคันที่ระบุ รายการนี้เป็นเพียงตัวอย่างบางส่วนเท่านั้น ระบบจะกรอกข้อมูลนี้ก็ต่อเมื่อ [fill_example_vehicle_indices_in_skipped_reasons][] เป็นจริง

ทดลอง: ลักษณะการทำงานหรือการมีอยู่ของฟิลด์นี้อาจมีการเปลี่ยนแปลงในอนาคต

string

หากรหัสเหตุผลคือ DEMAND_EXCEEDS_VEHICLE_CAPACITY แสดงว่าเอกสารมีประเภทความสามารถอย่างน้อย 1 ประเภทที่เกินขีดจำกัด

int32

หากเหตุผลเกี่ยวข้องกับการจัดส่งที่เข้ากันไม่ได้กับยานพาหนะ ฟิลด์นี้จะแสดงดัชนีของยานพาหนะที่เกี่ยวข้อง

Timestamp

เวลาเริ่มต้นของกรอบเวลาที่แน่นอน หากไม่ได้ระบุ ระบบจะตั้งค่าเป็น ShipmentModel.global_start_time

Timestamp

เวลาสิ้นสุดของกรอบเวลาที่แน่นอน หากไม่ได้ระบุ ระบบจะตั้งค่าเป็น ShipmentModel.global_end_time

Timestamp

เวลาเริ่มต้นแบบค่อยเป็นค่อยไปของกรอบเวลา

Timestamp

เวลาสิ้นสุดแบบยืดหยุ่นของกรอบเวลา

double

ต้นทุนต่อชั่วโมงที่เพิ่มลงในต้นทุนอื่นๆ ในโมเดลหากเหตุการณ์เกิดขึ้นก่อน soft_start_time โดยคำนวณดังนี้

   max(0, soft_start_time - t.seconds)
                          * cost_per_hour_before_soft_start_time / 3600,
t being the time of the event.

ค่าใช้จ่ายนี้ต้องเป็นค่าบวก และจะตั้งค่าฟิลด์ได้ก็ต่อเมื่อตั้งค่า soft_start_time แล้ว

double

ค่าใช้จ่ายต่อชั่วโมงที่เพิ่มลงในค่าใช้จ่ายอื่นๆ ในโมเดล หากเหตุการณ์เกิดขึ้นหลังจาก soft_end_time โดยคำนวณดังนี้

   max(0, t.seconds - soft_end_time.seconds)
                    * cost_per_hour_after_soft_end_time / 3600,
t being the time of the event.

ต้นทุนนี้ต้องเป็นค่าบวก และจะตั้งค่าช่องนี้ได้ก็ต่อเมื่อตั้งค่า soft_end_time แล้ว

string

แท็กที่กำหนดชุดการเปลี่ยน (src->dst) ที่แอตทริบิวต์เหล่านี้ใช้

การเข้าชมแหล่งที่มาหรือการเริ่มต้นยานพาหนะจะตรงกันก็ต่อเมื่อ VisitRequest.tags หรือ Vehicle.start_tags มี src_tag หรือไม่มี excluded_src_tag (ขึ้นอยู่กับว่าฟิลด์ใดใน 2 ฟิลด์นี้ไม่ใช่ฟิลด์ว่าง)

string

ดูsrc_tag ต้องมี src_tag และ excluded_src_tag อย่างใดอย่างหนึ่งที่ไม่ว่างเปล่า

string

การเข้าชมปลายทางหรือการสิ้นสุดของยานพาหนะจะตรงกันก็ต่อเมื่อ VisitRequest.tags หรือ Vehicle.end_tags มี dst_tag หรือไม่มี excluded_dst_tag (ขึ้นอยู่กับว่าฟิลด์ใดใน 2 ฟิลด์นี้ไม่ใช่ฟิลด์ว่าง)

string

ดูdst_tag ต้องมี dst_tag และ excluded_dst_tag อย่างใดอย่างหนึ่งที่ไม่ว่างเปล่า

double

ระบุค่าใช้จ่ายในการดำเนินการเปลี่ยนผ่านนี้ ซึ่งอยู่ในหน่วยเดียวกันกับต้นทุนอื่นๆ ทั้งหมดในโมเดล และต้องไม่ใช่ค่าลบ โดยจะมีการเรียกเก็บเพิ่มเติมจากค่าใช้จ่ายอื่นๆ ที่มีอยู่ทั้งหมด

double

ระบุต้นทุนต่อกิโลเมตรที่ใช้กับระยะทางที่เดินทางขณะทำการเปลี่ยนผ่านนี้ โดยจะรวมกับ Vehicle.cost_per_kilometer ที่ระบุในยานพาหนะ

DistanceLimit

ระบุขีดจำกัดของระยะทางที่เดินทางขณะทำการเปลี่ยนนี้

ตั้งแต่เดือนมิถุนายน 2021 เป็นต้นไป ระบบจะรองรับเฉพาะขีดจำกัดแบบยืดหยุ่น

Duration

ระบุการหน่วงเวลาที่เกิดขึ้นเมื่อทำการเปลี่ยนผ่านนี้

ความล่าช้านี้จะเกิดขึ้นหลังจากการเข้าชมแหล่งที่มาเสร็จสิ้นและก่อนเริ่มการเข้าชมหน้า Landing Page เสมอ

string

URI ของทรัพยากร ทรัพยากรอาจยังไม่มี

เนื้อหาของทรัพยากรจะได้รับการเข้ารหัสเป็น JSON หรือ Textproto ระบบรองรับเฉพาะทรัพยากร Google Cloud Storage หากทรัพยากรได้รับการเข้ารหัสเป็น JSON ชื่อทรัพยากรต้องลงท้ายด้วย .json หากมีการเข้ารหัสทรัพยากรเป็น Textproto ชื่อทรัพยากรต้องลงท้ายด้วย .txtpb เช่น URI ของ Google Cloud Storage ไปยังไฟล์ที่เข้ารหัส JSON อาจมีลักษณะดังนี้ gs://bucket/path/input/object.json

string

ชื่อที่แสดงของยานพาหนะที่กำหนดโดยผู้ใช้ มีความยาวได้สูงสุด 63 อักขระและอาจใช้อักขระ UTF-8

TravelMode

โหมดการเดินทางซึ่งส่งผลต่อถนนที่ยานพาหนะใช้ได้และความเร็วของยานพาหนะ ดู travel_duration_multiple เพิ่มเติม

RouteModifiers

ชุดเงื่อนไขที่ต้องปฏิบัติตามซึ่งส่งผลต่อวิธีคำนวณเส้นทางสำหรับยานพาหนะที่กำหนด

LatLng

สถานที่ตั้งทางภูมิศาสตร์ที่ยานพาหนะเริ่มก่อนรับสินค้า หากไม่ได้ระบุ ระบบจะเริ่มยานพาหนะที่จุดรับแรก หากรูปแบบการจัดส่งมีเมทริกซ์ระยะเวลาและระยะทาง คุณต้องไม่ระบุ start_location

Waypoint

จุดอ้างอิงที่แสดงถึงสถานที่ตั้งทางภูมิศาสตร์ซึ่งยานพาหนะเริ่มต้นก่อนรับสินค้า หากไม่ได้ระบุทั้ง start_waypoint และ start_location รถจะเริ่มที่จุดรับแรก หากรูปแบบการจัดส่งมีเมทริกซ์ระยะเวลาและระยะทาง คุณต้องไม่ระบุ start_waypoint

LatLng

สถานที่ตั้งทางภูมิศาสตร์ที่ยานพาหนะสิ้นสุดหลังจากที่VisitRequestสุดท้ายเสร็จสมบูรณ์ หากไม่ได้ระบุไว้ ShipmentRoute ของยานพาหนะจะสิ้นสุดทันทีเมื่อVisitRequestสุดท้ายเสร็จสมบูรณ์ หากรูปแบบการจัดส่งมีเมทริกซ์ระยะเวลาและระยะทาง คุณต้องไม่ระบุ end_location

Waypoint

จุดอ้างอิงที่แสดงถึงสถานที่ตั้งทางภูมิศาสตร์ซึ่งยานพาหนะจะสิ้นสุดหลังจากทำ VisitRequest สุดท้ายเสร็จแล้ว หากไม่ได้ระบุทั้ง end_waypoint และ end_location ShipmentRoute ของยานพาหนะจะสิ้นสุดทันทีเมื่อ VisitRequest ครั้งสุดท้ายเสร็จสมบูรณ์ หากรูปแบบการจัดส่งมีเมทริกซ์ระยะเวลาและระยะทาง คุณต้องไม่ระบุ end_waypoint

string

ระบุแท็กที่ติดไว้ที่จุดเริ่มต้นของเส้นทางของยานพาหนะ

ไม่อนุญาตให้ใช้สตริงที่ว่างเปล่าหรือซ้ำกัน

string

ระบุแท็กที่แนบไว้ที่ส่วนท้ายของเส้นทางของยานพาหนะ

ไม่อนุญาตให้ใช้สตริงที่ว่างเปล่าหรือซ้ำกัน

TimeWindow

ช่วงเวลาที่รถอาจออกจากตำแหน่งเริ่มต้น โดยต้องอยู่ภายในขีดจำกัดเวลาทั่วโลก (ดูฟิลด์ ShipmentModel.global_*) หากไม่ได้ระบุไว้ จะไม่มีข้อจำกัดใดๆ นอกเหนือจากขีดจำกัดเวลาทั่วโลก

กรอบเวลาที่อยู่ในฟิลด์ที่เกิดซ้ำเดียวกันต้องไม่ซ้อนทับกัน กล่าวคือ กรอบเวลาใดๆ จะซ้อนทับหรืออยู่ติดกับกรอบเวลาอื่นไม่ได้ และต้องเรียงตามลำดับเวลา

คุณจะตั้งค่า cost_per_hour_after_soft_end_time และ soft_end_time ได้ก็ต่อเมื่อมีกรอบเวลาเดียวเท่านั้น

TimeWindow

ช่วงเวลาที่ยานพาหนะอาจไปถึงจุดหมายปลายทาง โดยต้องอยู่ภายในขีดจำกัดเวลาทั่วโลก (ดูฟิลด์ ShipmentModel.global_*) หากไม่ได้ระบุไว้ จะไม่มีข้อจำกัดใดๆ นอกเหนือจากขีดจำกัดเวลาทั่วโลก

กรอบเวลาที่อยู่ในฟิลด์ที่เกิดซ้ำเดียวกันต้องไม่ซ้อนทับกัน กล่าวคือ กรอบเวลาใดๆ จะซ้อนทับหรืออยู่ติดกับกรอบเวลาอื่นไม่ได้ และต้องเรียงตามลำดับเวลา

คุณจะตั้งค่า cost_per_hour_after_soft_end_time และ soft_end_time ได้ก็ต่อเมื่อมีกรอบเวลาเดียวเท่านั้น

UnloadingPolicy

บังคับใช้นโยบายการขนถ่ายสินค้ากับยานพาหนะ

map<string, LoadLimit>

ความจุของยานพาหนะ (เช่น น้ำหนัก ปริมาตร จำนวนพาเล็ต) คีย์ในแผนที่เป็นตัวระบุประเภทการโหลด ซึ่งสอดคล้องกับคีย์ของฟิลด์ Shipment.load_demands หากไม่มีคีย์ที่ระบุในแผนที่นี้ ระบบจะถือว่าความจุที่เกี่ยวข้องนั้นไม่จำกัด

double

ค่าใช้จ่ายของยานพาหนะ: ค่าใช้จ่ายทั้งหมดจะรวมกันและต้องอยู่ในหน่วยเดียวกันกับ Shipment.penalty_cost

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

double

ต้นทุนต่อชั่วโมงที่เดินทางของเส้นทางยานพาหนะ ต้นทุนนี้จะมีผลกับเวลาเดินทางที่ใช้ในเส้นทางเท่านั้น (กล่าวคือ เวลาที่รายงานใน ShipmentRoute.transitions) และไม่รวมเวลารอและเวลาเข้าชม

double

ต้นทุนต่อกิโลเมตรของเส้นทางยานพาหนะ ค่าใช้จ่ายนี้จะใช้กับระยะทางที่รายงานใน ShipmentRoute.transitions และจะไม่ใช้กับระยะทางที่เดินทางโดยนัยจาก arrival_location ไปยัง departure_location ของ VisitRequest รายการเดียว

double

ค่าใช้จ่ายคงที่ที่ใช้หากใช้ยานพาหนะนี้ในการจัดการการจัดส่ง

bool

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

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

ไม่เช่นนั้น รถจะไม่เดินทางจากจุดเริ่มต้นไปยังจุดสิ้นสุด และจะไม่มีการกำหนดเวลา break_rule หรือความล่าช้า (จาก TransitionAttributes) สำหรับรถคันนี้ ในกรณีนี้ ShipmentRoute ของยานพาหนะจะไม่มีข้อมูลใดๆ ยกเว้นดัชนีและป้ายกำกับของยานพาหนะ

DurationLimit

ขีดจำกัดที่ใช้กับระยะเวลาทั้งหมดของเส้นทางของยานพาหนะ ในOptimizeToursResponseที่กำหนด ระยะเวลาของเส้นทางของยานพาหนะคือความแตกต่างระหว่างvehicle_end_timeและvehicle_start_time

DurationLimit

ขีดจำกัดที่ใช้กับระยะเวลาการเดินทางของเส้นทางยานพาหนะ ในOptimizeToursResponseที่กำหนด ระยะเวลาการเดินทางของเส้นทางคือผลรวมของtransitions.travel_durationทั้งหมด

DistanceLimit

ขีดจำกัดที่ใช้กับระยะทางรวมของเส้นทางยานพาหนะ ใน OptimizeToursResponse ที่กำหนด ระยะทางของเส้นทางคือผลรวมของ transitions.travel_distance_meters ทั้งหมด

map<string, Duration>

ระบุแมปจากสตริง visit_types ไปยังระยะเวลา ระยะเวลาคือเวลาที่เพิ่มจาก VisitRequest.duration ซึ่งจะใช้ในการเข้าชมที่มี visit_types ที่ระบุ ระยะเวลาการเข้าชมเพิ่มเติมนี้จะเพิ่มค่าใช้จ่ายหากมีการระบุ cost_per_hour คีย์ (เช่น visit_types) ต้องไม่ใช่สตริงว่าง

หากคำขอเข้าชมมีหลายประเภท ระบบจะเพิ่มระยะเวลาสำหรับแต่ละประเภทในแผนที่

BreakRule

อธิบายกำหนดเวลาพักที่จะบังคับใช้กับยานพาหนะนี้ หากเว้นว่างไว้ ระบบจะไม่กำหนดเวลาพักสำหรับยานพาหนะนี้

string

ระบุป้ายกำกับสำหรับยานพาหนะนี้ ป้ายกำกับนี้จะรายงานในคำตอบเป็น vehicle_label ของ ShipmentRoute ที่เกี่ยวข้อง

bool

หากเป็นจริง used_if_route_is_empty ต้องเป็นเท็จ และยานพาหนะนี้จะยังคงไม่ได้ใช้งาน

หากมีการจัดส่งโดยยานพาหนะที่ถูกละเว้นใน injected_first_solution_routes ระบบจะข้ามการจัดส่งดังกล่าวในโซลูชันแรก แต่จะดำเนินการในการตอบกลับได้

หากการจัดส่งดำเนินการโดยยานพาหนะที่ถูกละเว้นใน injected_solution_constraint และการรับ/นำส่งที่เกี่ยวข้องถูกจำกัดให้อยู่ในยานพาหนะ (กล่าวคือ ไม่ได้ผ่อนปรนเป็นระดับ RELAX_ALL_AFTER_THRESHOLD) ระบบจะข้ามการจัดส่งดังกล่าวในการตอบกลับ หากการจัดส่งมีฟิลด์ allowed_vehicle_indices ที่ไม่ว่างเปล่าและระบบเพิกเฉยต่อยานพาหนะที่อนุญาตทั้งหมด ระบบจะข้ามการจัดส่งดังกล่าวในคำตอบ

double

ระบุปัจจัยการคูณที่ใช้เพื่อเพิ่มหรือลดเวลาเดินทางของยานพาหนะนี้ได้ เช่น การตั้งค่านี้เป็น 2.0 หมายความว่ารถคันนี้ช้ากว่าและมีเวลาเดินทางเป็น 2 เท่าของรถยนต์มาตรฐาน ตัวคูณนี้ไม่มีผลต่อระยะเวลาเข้าชม แต่จะส่งผลต่อค่าใช้จ่ายหากมีการระบุ cost_per_hour หรือ cost_per_traveled_hour ซึ่งต้องอยู่ในช่วง [0.001, 1000.0] หากไม่ได้ตั้งค่าไว้ รถจะเป็นรถมาตรฐาน และตัวคูณนี้จะถือเป็น 1.0

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

ดูextra_visit_duration_for_visit_typeด้านล่างด้วย

Duration

ขีดจำกัดที่กำหนดให้ระยะเวลาไม่เกิน max_duration

Duration

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

หากกำหนดไว้ soft_max_duration ต้องไม่เป็นค่าลบ หากมีการกำหนด max_duration ด้วย soft_max_duration ต้องน้อยกว่า max_duration

Duration

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

หากกำหนดไว้ quadratic_soft_max_duration ต้องไม่เป็นค่าลบ หากมีการกำหนด max_duration ด้วย quadratic_soft_max_duration ต้องน้อยกว่า max_duration และความแตกต่างต้องไม่เกิน 1 วัน

max_duration - quadratic_soft_max_duration <= 86400 seconds

double

ค่าใช้จ่ายต่อชั่วโมงที่เกิดขึ้นหากมีการละเมิดsoft_max_durationเกณฑ์ ค่าใช้จ่ายเพิ่มเติมจะเป็น 0 หากระยะเวลาต่ำกว่าเกณฑ์ มิฉะนั้นค่าใช้จ่ายจะขึ้นอยู่กับระยะเวลาดังนี้

  cost_per_hour_after_soft_max * (duration - soft_max_duration)

ค่าใช้จ่ายต้องไม่ติดลบ

double

ค่าใช้จ่ายต่อชั่วโมงต่อตารางเมตรที่เกิดขึ้นหากมีการละเมิดquadratic_soft_max_durationเกณฑ์

ค่าใช้จ่ายเพิ่มเติมจะเป็น 0 หากระยะเวลาต่ำกว่าเกณฑ์ มิฉะนั้นค่าใช้จ่ายจะขึ้นอยู่กับระยะเวลาดังนี้

  cost_per_square_hour_after_quadratic_soft_max *
  (duration - quadratic_soft_max_duration)^2

ค่าใช้จ่ายต้องไม่ติดลบ

int64

ขีดจำกัดแบบไม่เข้มงวดของภาระงาน ดูcost_per_unit_above_soft_max

double

หากน้ำหนักบรรทุกเกิน soft_max_load ตามเส้นทางของยานพาหนะนี้ จะมีการลงโทษด้านต้นทุนดังต่อไปนี้ (ครั้งเดียวต่อยานพาหนะ) (น้ำหนักบรรทุก - soft_max_load) * cost_per_unit_above_soft_max ค่าใช้จ่ายทั้งหมดจะรวมกันและต้องอยู่ในหน่วยเดียวกันกับ Shipment.penalty_cost คุณกำหนดขีดจำกัดแบบยืดหยุ่นได้เฉพาะในประเภทที่มีผลกับการรับสินค้าเท่านั้นหรือการนำส่งเท่านั้นทั่วทั้งโมเดล

Interval

ช่วงเวลาที่ยอมรับได้ในการบรรทุกของยานพาหนะเมื่อเริ่มเส้นทาง

Interval

ช่วงเวลาที่ยอมรับได้ในการบรรทุกยานพาหนะที่จุดสิ้นสุดของเส้นทาง

int64

ปริมาณการโหลดสูงสุดที่ยอมรับได้

LoadCost

ค่าใช้จ่ายในการเคลื่อนย้ายน้ำหนัก 1 หน่วยเป็นระยะทาง 1 กิโลเมตรสำหรับยานพาหนะนี้ ซึ่งใช้เป็นตัวแทนของปริมาณการใช้เชื้อเพลิงได้ หากโหลดเป็นน้ำหนัก (ในหน่วยนิวตัน) โหลด*กิโลเมตรจะมีมิติของพลังงาน

ทดลอง: ดูรายละเอียดเพิ่มเติมได้ที่ https://developers.google.com/maps/tt/route-optimization/experimental/load-cost/make-request

LoadCost

ค่าใช้จ่ายในการเดินทางพร้อมสัมภาระ 1 หน่วยเป็นเวลา 1 ชั่วโมงสำหรับยานพาหนะนี้

ทดลอง: ดูรายละเอียดเพิ่มเติมได้ที่ https://developers.google.com/maps/tt/route-optimization/experimental/load-cost/make-request

int64

โหลดขั้นต่ำที่ยอมรับได้ ต้อง ≥ 0 หากระบุทั้ง 2 ค่า min ต้อง ≤ max

int64

โหลดสูงสุดที่ยอมรับได้ ต้อง ≥ 0 หากไม่ได้ระบุไว้ ข้อความนี้จะไม่จำกัดการโหลดสูงสุด หากระบุทั้ง 2 ค่า min ต้อง ≤ max

int64

ปริมาณการโหลดที่สูงกว่านี้จะทำให้ต้นทุนในการย้ายหน่วยการโหลดเปลี่ยนจาก cost_per_unit_below_threshold เป็น cost_per_unit_above_threshold ต้องมีค่ามากกว่าหรือเท่ากับ 0

double

ต้นทุนในการย้ายหน่วยของภาระงานสำหรับแต่ละหน่วยระหว่าง 0 กับเกณฑ์ ต้องเป็นค่าที่สิ้นสุดและมากกว่าหรือเท่ากับ 0

double

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

double

ค่าสูงสุดของฟิลด์อื่นๆ ทั้งหมดในข้อความนี้

double

อัตราส่วนระหว่าง AggregatedMetrics.travel_distance_meters กับ Vehicle.route_distance_limit หากไม่ได้ตั้งค่า Vehicle.route_distance_limit ระบบจะไม่ได้ตั้งค่าช่องนี้

double

อัตราส่วนระหว่าง [AggregatedMetrics.travel_duration_seconds][] กับ Vehicle.travel_duration_limit หากไม่ได้ตั้งค่า Vehicle.travel_duration_limit ระบบจะไม่ได้ตั้งค่าช่องนี้

double

อัตราส่วนระหว่าง [AggregatedMetrics.total_duration_seconds][] กับ Vehicle.route_duration_limit หากไม่ได้ตั้งค่า Vehicle.route_duration_limit ระบบจะไม่ได้ตั้งค่าช่องนี้

double

อัตราส่วนสูงสุดใน [AggregatedMetrics.max_load][] ทุกประเภทและ Vehicle.load_limits ที่เกี่ยวข้อง หากไม่ได้ตั้งค่าฟิลด์ Vehicle.load_limits ทั้งหมด ระบบจะไม่ได้ตั้งค่าฟิลด์นี้

double

สัดส่วน (vehicle_end_time - vehicle_start_time) / (latest_vehicle_end_time - earliest_vehicle_start_time) สำหรับยานพาหนะที่กำหนด หากไม่มีตัวหาร ระบบจะใช้ (ShipmentModel.global_end_time - ShipmentModel.global_start_time) แทน

bool

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

bool

ระบุว่าจุดแวะพักมีไว้เพื่อให้ยานพาหนะหยุด โดยมีจุดประสงค์เพื่อรับหรือส่ง ตัวเลือกนี้ใช้ได้เฉพาะโหมดการเดินทาง "DRIVING" และเมื่อ "location_type" เป็น "location"

ทดลอง: ลักษณะการทำงานหรือการมีอยู่ของฟิลด์นี้อาจมีการเปลี่ยนแปลงในอนาคต

Location

จุดที่ระบุโดยใช้พิกัดทางภูมิศาสตร์ รวมถึงส่วนหัวที่ไม่บังคับ

string

รหัสสถานที่ของจุดสนใจที่เชื่อมโยงกับจุดแวะพัก

เมื่อใช้รหัสสถานที่เพื่อระบุสถานที่มาถึงหรือสถานที่ออกเดินทางของ VisitRequest ให้ใช้รหัสสถานที่ที่เฉพาะเจาะจงเพียงพอที่จะกำหนดตำแหน่ง LatLng สำหรับการนำทางไปยังสถานที่นั้น เช่น รหัสสถานที่ที่แสดงถึงอาคารจะเหมาะสม แต่ไม่แนะนำให้ใช้รหัสสถานที่ที่แสดงถึงถนน