เอกสารนี้จะอธิบายวิธีแสดงรายการยานพาหนะที่นำส่งสินค้า
สภาพแวดล้อมและข้อจำกัด
คุณแสดงรายการยานพาหนะสำหรับนำส่งได้จากเซิร์ฟเวอร์หรือสภาพแวดล้อมเบราว์เซอร์ ผู้ขับขี่ SDK ไม่รองรับยานพาหนะสำหรับนำส่งข้อมูล
การระบุยานพาหนะนำส่งเป็นการขอสิทธิ์เข้าถึงยานพาหนะนำส่งอย่างกว้างขวางและมีไว้สำหรับผู้ใช้ที่เชื่อถือเท่านั้น ใช้ Send Fleet Reader หรือ Fleet Engine โทเค็นผู้ดูแลระบบการนำส่งเมื่อจัดทำคำขอรายการยานพาหนะนำส่ง
ยานพาหนะสำหรับนำส่งที่ระบุไว้มีการปกปิดช่องต่อไปนี้เนื่องจากผลกระทบ ในขนาดการตอบกลับ:
CurrentRouteSegment
RemainingVehicleJourneySegments
การใช้งาน
คุณสามารถแสดงยานพาหนะตามตัวกรองแอตทริบิวต์และขอบเขตวิวพอร์ตได้ หากระบุ ไม่มีตัวกรองหรือวิวพอร์ต การตอบกลับจะรวมยานพาหนะสำหรับนำส่งทั้งหมด
รายการที่มีตัวกรองแอตทริบิวต์
คุณแสดงรายการยานพาหนะสำหรับนำส่งสินค้าได้โดยตัวกรองโดยใช้พร็อพเพอร์ตี้ attributes
เช่น หากต้องการค้นหาแอตทริบิวต์ที่มีคีย์ my_key
และค่า my_value
ให้ใช้ attributes.my_key = my_value
หากต้องการค้นหาแอตทริบิวต์หลายรายการ ให้รวมการค้นหาเข้าด้วยกัน
โดยใช้โอเปอเรเตอร์ AND
และ OR
แบบลอจิคัล เช่น attributes.key1 = value1 AND
attributes.key2 = value2
ดู AIP-160 สำหรับคำอธิบายทั้งหมด
ของไวยากรณ์การค้นหาตัวกรอง หากคุณรวมตัวกรองเข้ากับขอบเขตวิวพอร์ต ตัวกรองจะทําหน้าที่เป็นโอเปอเรเตอร์ AND
กับขอบเขตวิวพอร์ต ดูรายละเอียดได้ที่การกรองข้อความค้นหาแอตทริบิวต์ยานพาหนะ
รายการที่มีขอบเขตของวิวพอร์ต
คุณกรองยานพาหนะนำส่งที่แสดงตามสถานที่ตั้งได้โดยใช้พารามิเตอร์ viewport
request
พารามิเตอร์คำขอ viewport
กำหนดวิวพอร์ตโดยใช้ขอบเขต 2 แบบ
พิกัด: ละติจูดและลองจิจูด high
(ตะวันออกเฉียงเหนือ) และ low
(ตะวันตกเฉียงใต้)
คู่พิกัด คำขอจะถูกปฏิเสธหากมีละติจูดสูง
ที่มีตำแหน่งทางภูมิศาสตร์ต่ำกว่าละติจูดต่ำ
แสดงรายการการตอบกลับ
ระบบจะแบ่งรายการยานพาหนะนำส่งเป็นหน้าๆ โดยค่าเริ่มต้นโดยใช้ขนาดหน้าที่เหมาะสม ถ้า ที่คุณระบุขนาดหน้าเว็บ คำขอจะแสดงเฉพาะจำนวนยานพาหนะ ตามขีดจำกัดหรือน้อยกว่า หากขนาดหน้าที่ขอเกินขนาดภายใน ระบบจะใช้ค่าสูงสุดภายใน หน้าเว็บเริ่มต้นและหน้าสูงสุด ขนาดต่างๆ เป็นยานพาหนะ 100 คัน
รายการยานพาหนะที่นำส่งสามารถรวมโทเค็นสำหรับอ่านหน้าถัดไปของ รายการ โทเค็นหน้าจะแสดงเฉพาะในการตอบสนองเมื่อมีหน้าการแสดงโฆษณามากขึ้นเท่านั้น และสามารถนำรถมาคืนได้ หากต้องการดึงข้อมูลหน้าถัดไปของงาน ให้ใช้ โทเค็นหน้าเว็บที่มีคำขอที่เหมือนกับ อีกครั้ง
แสดงรายการตัวอย่างยานพาหนะ
คุณสามารถใช้ไลบรารี Java gRPC หรือ REST เพื่อแสดงยานพาหนะสำหรับนำส่งใน ที่มีแอตทริบิวต์บางอย่าง การตอบกลับที่ประสบความสำเร็จก็ยังได้ ว่างเปล่า ในกรณีนี้หมายความว่าไม่มียานพาหนะที่มีแอตทริบิวต์ที่ระบุ อยู่ในวิวพอร์ตที่ระบุ
Java
static final String PROJECT_ID = "my-delivery-co-gcp-project";
DeliveryServiceBlockingStub deliveryService =
DeliveryServiceGrpc.newBlockingStub(channel);
// Tasks request
String parent = "providers/" + PROJECT_ID;
ListDeliveryVehiclesRequest listDeliveryVehiclesRequest =
ListDeliveryVehiclesRequest.newBuilder() // No need for the header
.setParent(parent)
.setViewport(
Viewport.newBuilder()
.setHigh(LatLng.newBuilder()
.setLatitude(37.45)
.setLongitude(-122.06)
.build())
.setLow(LatLng.newBuilder()
.setLatitude(37.41)
.setLongitude(-122.11)
.build())
.setFilter("attributes.my_key = my_value")
.build();
try {
ListDeliveryVehiclesResponse listDeliveryVehiclesResponse =
deliveryService.listDeliveryVehicles(listDeliveryVehiclesRequest);
} catch (StatusRuntimeException e) {
Status s = e.getStatus();
switch (s.getCode()) {
case NOT_FOUND:
break;
case PERMISSION_DENIED:
break;
}
return;
}
REST
# HTTP request
html GET https://fleetengine.googleapis.com/v1/providers/<project_id>/deliveryVehicles
# Request with a filter
# Request sets JWT, PROJECT_ID, and VEHICLE_ID in the local environment
curl -H "Authorization: Bearer ${JWT}" \
"https://fleetengine.googleapis.com/v1/providers/${PROJECT_ID}/deliveryVehicles?filter=attributes.my_key%20%3D%20my_value%20&viewport.high.latitude=37.45&viewport.high.longitude=-122.06&viewport.low.latitude=37.41&viewport.low.longitude=-122.11"
หากการค้นหาสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลดังต่อไปนี้ โครงสร้าง:
// JSON representation
{
"deliveryVehicles": [
{
object (DeliveryVehicle)
}
],
"nextPageToken": string,
"totalSize": integer
}