قبل استخدام Location Selection API للبحث عن نقاط الركوب، اتّبِع التعليمات لدمجها مع مكتبة البرامج.
توفّر خدمة "اختيار الموقع الجغرافي" ثلاث واجهات برمجة تطبيقات لاختيار موقعَي الاستلام والتسليم: FindNearbyPlaces وFindPickupPointsForPlace وFindPickupPointsForLocation.
استخدِم FindNearbyPlaces لجلب الأماكن القريبة من الموقع الجغرافي للجهاز أو الموقع الجغرافي المحدّد في البحث. يتم ترتيب الأماكن حسب مدى قربها من الموقع الجغرافي ومدى بروزها في خدمات النقل التشاركي. تعرض الدالة FindNearbyPlaces قائمة بالأماكن التي يمكن عرضها
للسماح للمستخدم باختيار أفضل مكان. بعد اختيار مكان، استخدِم
FindPickupPointsForPlace لاسترجاع نقاط الاستلام للمكان المحدّد.
استخدِم FindPickupPointsForLocation لجلب الأماكن ونقاط الاستلام المرتبطة بها بالقرب من الموقع الجغرافي للجهاز أو الموقع الجغرافي الذي تم البحث عنه في طلب RPC نفسه.
ترتبط كل نقطة استلام بمكان. يتم ترتيب نقاط الالتقاء حسب قربها من الموقع الجغرافي ومدى بروزها في خدمة مشاركة الرحلات. يُرجى العِلم أنّه يتم ترتيب نقاط الاستلام
لأماكن متعددة معًا. يجمع "FindPickupPointsForLocation" بين
"FindNearbyPlaces" و"FindPickupPointsForPlace". على سبيل المثال، لنفترض أنّ الموقع الجغرافي للطلب
قريب من المكان "أ" و"ب" و"ج". إذا كانت أفضل نقطة التقاء 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 ويمكن استخدامه بدلاً من الجمع بين الطلبَين الآخرَين.
البحث حسب رقم تعريف المكان
يمكنك الحصول على 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
المركّبات المرتبطة بالمكان. تحتوي الرسالة المركّبة على ثلاثة أنواع من المعلومات:
- نوع المركّب: أحد الخيارات الأربعة التالية:
compoundBuilding: مبنى واحد مستقل، مثل مركز تسوّق أو سوبرماركت-
compoundSection: مجمّع داخل مجمّع أكبر، مثل متجر واحد في مركز تسوّق compoundGrounds: كل ما يرتبط بـcompoundBuilding، مثل مركز تجاري وموقف السيارات الخاص به وأي مبانٍ أخرى داخل موقف السيارات هذا-
unrecognized: القيمة التلقائية
- الهندسة: إحداثيات المضلّع المحدّد، ويتم تخزينها في بنية GeoJSON في الحقل
displayBoundary. تُستخدم هذه الإحداثيات لإنشاء المخطط التفصيلي للقسم أو المبنى أو الأرض. - المداخل: إحداثيات خطوط العرض والطول لجميع المداخل والمخارج التي تم تحديد موقعها
تعرض ميزة "اختيار الموقع الجغرافي" أي نوع مركّب مرتبط بالموقع الجغرافي الذي تم البحث عنه. إذا كان الموقع الجغرافي الذي يتم البحث عنه في متجر معيّن في مركز تسوّق، تعرض واجهة برمجة التطبيقات "اختيار الموقع الجغرافي" ما يلي: * المتجر المحدّد ومداخله ومخارجه ومخططه التفصيلي * المبنى المركّب (مركز التسوّق) ومداخله ومخارجه ومخططه التفصيلي * أرض المبنى المركّب (مركز التسوّق وموقف السيارات) ومداخلها ومخارجها والمخطط التفصيلي للأرض بأكملها
تعرض هذه الصورة جميع أنواع المركّبات الثلاثة التي يتم عرضها.

تعرض هذه الصورة عدة مواقع جغرافية داخل مطار، مع حدود كل من مبنى داخل المطار وحدود المطار وجميع الأراضي ذات الصلة.
