ก่อนใช้ Location Selection API เพื่อค้นหาจุดรับผู้โดยสาร ให้ทำตามวิธีการเพื่อผสานรวมกับไลบรารีของไคลเอ็นต์
บริการเลือกสถานที่ตั้งมี API 3 รายการสำหรับการเลือกจุดรับและจุดส่ง ได้แก่ FindNearbyPlaces, FindPickupPointsForPlace และ FindPickupPointsForLocation
ใช้ FindNearbyPlaces เพื่อดึงข้อมูลสถานที่ใกล้กับตำแหน่งการค้นหาหรือตำแหน่งของอุปกรณ์ ระบบจะจัดอันดับสถานที่ตามความใกล้ชิดกับสถานที่ตั้งและความโดดเด่นสำหรับการแชร์รถ FindNearbyPlaces จะแสดงรายการสถานที่ที่สามารถแสดงได้เพื่อให้ผู้ใช้เลือกตัวเลือกที่ดีที่สุด เมื่อเลือกสถานที่แล้ว ให้ใช้ FindPickupPointsForPlace เพื่อดึงข้อมูลจุดรับสินค้าสำหรับสถานที่ที่เลือก
ใช้ FindPickupPointsForLocation เพื่อดึงข้อมูลสถานที่และจุดรับที่เกี่ยวข้องซึ่งอยู่ใกล้กับสถานที่ที่ค้นหาหรือตำแหน่งของอุปกรณ์ในการเรียก RPC เดียวกัน
จุดรับแต่ละจุด
จะเชื่อมโยงกับสถานที่ ระบบจะจัดอันดับจุดรับตามความใกล้กับสถานที่และความโดดเด่นสำหรับการแชร์รถ โปรดทราบว่าจุดรับสินค้าสำหรับสถานที่หลายแห่งจะเรียงลำดับไว้ด้วยกัน FindPickupPointsForLocation รวม FindNearbyPlaces และ FindPickupPointsForPlace เข้าด้วยกัน เช่น สมมติว่าตำแหน่งของคำขออยู่ใกล้กับสถานที่ P1, P2 และ P3 หากจุดรับผู้โดยสารที่ดีที่สุด T1 เชื่อมโยงกับสถานที่ P2 และจุดรับผู้โดยสารที่ดีที่สุดถัดไปเชื่อมโยงกับสถานที่ P1 ผลลัพธ์จะมีการจัดลำดับ [T1:P2, T2:P1, ...]
การจัดอันดับจุดรับสินค้าจะขึ้นอยู่กับเกณฑ์ที่ระบุไว้ในคำขอ ดูข้อมูลเพิ่มเติมได้ที่การเพิ่มประสิทธิภาพการรับผู้โดยสารสำหรับการเดินทางหลายครั้ง
ค้นหาตามสถานที่ตั้ง
หากต้องการแสดงสถานที่แก่ผู้ใช้ก่อนที่จะเลือกจุดรับ หรือแสดงสถานที่ใกล้เคียงโดยการลากหมุด ให้ใช้การเรียก RPC ต่อไปนี้
FindNearbyPlacesRequest find_nearby_places_request =
FindNearbyPlacesRequest.newBuilder()
.setLocalizationPreferences(LocalizationPreferences.newBuilder()
// Language used for localizing text such as name or address.
.setLanguageCode("en")
.setRegionCode("US")
.build())
// Rider's location or location of dragged pin.
.setSearchLocation(LatLng.newBuilder().setLatitude(37.365647).setLongitude(-121.925356))
// Number of places requested.
.setMaxResults(3)
.build();
FindNearbyPlacesResponse findNearbyPlacesResponse =
locationSelectionBetaClient.findNearbyPlaces(find_nearby_places_request);
การเรียก RPC จะแสดงรายการคำตอบเกี่ยวกับสถานที่ที่จัดอันดับซึ่งเป็นไปตามเกณฑ์อินพุต โดยจัดเรียงตามความใกล้ชิดและความโดดเด่นรวมกัน คุณสามารถให้ผู้โดยสารเลือกสถานที่หรือใช้ผลการค้นหาแรกและดำเนินการเลือกจุดรับส่งได้ การตอบกลับสถานที่แต่ละรายการจะมี place_id ที่ไม่ซ้ำกันซึ่งสามารถใช้ใน FindPickupPointsForPlaceRequest เพื่อดึงข้อมูลจุดรับได้ ดูข้อมูลเพิ่มเติมได้ที่ค้นหาตามรหัสสถานที่
FindPickupPointsForLocationRequest FindPickupPointsForLocationRequest =
FindPickupPointsForLocationRequest.newBuilder()
// Language used for localizing text such as name and address.
.setLocalizationPreferences(LocalizationPreferences.newBuilder().setRegionCode("US").setLanguageCode("en"))
// The search location of the rider or the dropped pin.
.setSearchLocation(LatLng.newBuilder().setLatitude(-23.482049).setLongitude(-46.602135))
// The max results returned.
.setMaxResults(5)
// List of travel modes. At least one of the travel modes must be supported by the pickup points.
.addTravelModes(TravelMode.DRIVING)
// Specifies the sorting order of matching pickup points.
.setOrderBy(PickupPointOrder.DISTANCE_FROM_SEARCH_LOCATION)
.build();
FindPickupPointsForLocationResponse FindPickupPointsForLocationResponse =
locationSelectionService.FindPickupPointsForLocation(
RpcClientContext.create(), FindPickupPointsForLocationRequest);
การเรียก RPC จะแสดงรายการจุดรับพัสดุที่จัดอันดับซึ่งตรงตามเกณฑ์อินพุต โดยจัดเรียงตามความใกล้ชิดและความโดดเด่นรวมกัน การเรียก RPC นี้จะรวม FindNearbyPlaces และ FindPickupPointsForPlaceRequest เข้าด้วยกัน และสามารถใช้แทนการรวมการเรียกอีก 2 รายการได้
ค้นหาตามรหัสสถานที่
คุณสามารถรับ place_id โดยใช้ FindNearbyPlaces หรือใช้บริการเติมข้อความอัตโนมัติของ Places API จากนั้นใช้การเรียก RPC ต่อไปนี้เพื่อระบุจุดรับที่เหมาะสมที่สุดสำหรับสถานที่ที่ระบุ
FindPickupPointsForPlaceRequest findPickupPointsForPlaceRequest =
FindPickupPointsForPlaceRequest.newBuilder()
// Language used for localizing text such as name and address.
.setLocalizationPreferences(LocalizationPreferences.newBuilder().setRegionCode("US").setLanguageCode("en"))
// Place ID of the place for which pickup points are being fetched;
// for example, Hilton Hotel, Downtown San Jose.
.setPlaceId("ChIJwTUa-q_Mj4ARff4yludGH-M")
// List of travel modes. At least one of the travel modes must be supported by the pickup points.
.addTravelModes(TravelMode.DRIVING)
// Rider's location or location of dragged pin.
// It is recommended to use the same location that was used in `FindNearbyPlaces` for better quality.
.setSearchLocation(LatLng.newBuilder().setLatitude(37.329472).setLongitude(-121.890449))
.setOrderBy(PickupPointOrder.DISTANCE_FROM_SEARCH_LOCATION)
.setMaxResults(5)
.build();
FindPickupPointsForPlaceResponse findPickupPointsForPlaceResponse =
locationSelectionBetaClient.findPickupPointsForPlace(findPickupPointsForPlaceRequest);
FindPickupPointsForPlace จะแสดงผล PickupPointResponses พร้อมละติจูดและลองจิจูดสำหรับจุดที่ผู้ขับขี่สามารถรับผู้โดยสารได้
เพิ่มประสิทธิภาพการรับผู้โดยสารสำหรับการเดินทางหลายครั้ง
สำหรับการเดินทางแบบแชร์หรือแบบต่อเนื่อง FindPickupPointsForPlace รองรับการจัดเรียงจุดรับตามDRIVING_ETA_FROM_PICKUP_POINT_TO_DESTINATION ซึ่งจะช่วยให้คุณแสดงจุดรับสำหรับการเดินทางครั้งถัดไปที่ได้รับการเพิ่มประสิทธิภาพด้วยเส้นทางการเดินทางปัจจุบันของคนขับ
ตัวอย่าง
FindPickupPointsForPlaceRequest findPickupPointsForPlaceRequest =
FindPickupPointsForPlaceRequest.newBuilder()
// Language used for localizing text such as name and address.
.setLocalizationPreferences(LocalizationPreferences.newBuilder().setRegionCode("US").setLanguageCode("en"))
// Place ID of the place for which pickup points are being fetched;
// for example, Hilton Hotel, Downtown San Jose.
.setPlaceId("ChIJwTUa-q_Mj4ARff4yludGH-M")
// List of travel modes. At least one of the travel modes must be supported by the pickup points.
.addTravelModes(TravelMode.DRIVING)
// Second rider's location or location of dragged pin.
.setSearchLocation(LatLng.newBuilder().setLatitude(37.329472).setLongitude(-121.890449))
// Location of the driver's next drop off after picking up the second
// rider. Note, it is not necessarily the second rider's destination.
.setDestination(LatLng.newBuilder().setLatitude(37.329472).setLongitude(-121.890449))
.setOrderBy(PickupPointOrder.DRIVING_ETA_FROM_PICKUP_POINT_TO_DESTINATION)
.setComputeDrivingEta(true)
.setMaxResults(5)
.build();
FindPickupPointsForPlaceResponse findPickupPointsForPlaceResponse =
locationSelectionBetaClient.findPickupPointsForPlace(findPickupPointsForPlaceRequest);
แสดงโครงร่างอาคาร ทางเข้า และทางออก
ภายในข้อความตอบกลับโปรโตของสถานที่ ฟิลด์ associatedCompounds จะระบุสารประกอบที่เชื่อมโยงกับสถานที่นั้น ข้อความแบบผสมประกอบด้วยข้อมูล 3 ประเภท ได้แก่
- ประเภทสารประกอบ - ตัวเลือกใดตัวเลือกหนึ่งจาก 4 ตัวเลือก
compoundBuilding- อาคารเดี่ยวแบบสแตนด์อโลน เช่น ห้างสรรพสินค้าหรือซูเปอร์มาร์เก็ตcompoundSection- สถานที่ตั้งภายในสถานที่ตั้งที่ใหญ่กว่า เช่น ร้านค้าเดี่ยวในห้างสรรพสินค้าcompoundGrounds- ทุกอย่างที่เชื่อมโยงกับcompoundBuildingเช่น ห้างสรรพสินค้า ที่จอดรถ และอาคารอื่นๆ ภายในที่จอดรถนั้นunrecognized- ค่าเริ่มต้น
- เรขาคณิต - พิกัดของรูปหลายเหลี่ยมที่ระบุไว้ ซึ่งจัดเก็บไว้ในโครงสร้าง GeoJSON ในช่อง
displayBoundaryระบบจะใช้พิกัดเหล่านี้เพื่อสร้างโครงร่างของส่วน อาคาร หรือพื้นที่ - ทางเข้า - พิกัดละติจูดและลองจิจูดของทางเข้าและทางออกทั้งหมดที่ตั้งอยู่
การเลือกสถานที่ตั้งจะแสดงผลประเภทสารประกอบที่เชื่อมโยงกับสถานที่ตั้งที่ค้นหา หากสถานที่ค้นหาอยู่ในร้านค้าหนึ่งๆ ในห้างสรรพสินค้า การเลือกสถานที่ตั้งจะแสดงผลดังนี้ * ร้านค้าที่เฉพาะเจาะจง ทางเข้าและทางออก รวมถึงโครงร่างของร้านค้า * อาคารที่ซับซ้อน (ห้างสรรพสินค้า) ทางเข้าและทางออก รวมถึงโครงร่างของห้างสรรพสินค้า * พื้นที่ที่ซับซ้อน (ห้างสรรพสินค้า + ลานจอดรถ) ทางเข้าและทางออก รวมถึงโครงร่างของพื้นที่ทั้งหมด
รูปภาพนี้แสดงประเภทสารประกอบทั้ง 3 ประเภทที่แสดงผล

รูปภาพนี้แสดงสถานที่หลายแห่งภายในสนามบิน โดยมีขอบเขตของทั้งอาคารภายในสนามบินและขอบเขตของสนามบินและพื้นที่ที่เกี่ยวข้องทั้งหมด
