قبلاز استفاده از Location Selection API برای جستجوی نقاط سوار شدن، دستورالعملهای ادغام با کتابخانه کارخواه را دنبال کنید.
سرویس «انتخاب مکان» سه میانای برنامهسازی کاربردی برای انتخاب سوار کردن و پیاده کردن ارائه میدهد: 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 را ترکیب میکند و میتواند
بهجای ترکیب دو فراخوانی دیگر استفاده شود.
جستجو براساس شناسه مکان
میتوانید 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ذخیره شده است. از این مختصات برای ساختن طرح کلی بخش، ساختمان، یا محوطه استفاده میشود. - ورودیها - مختصات طول و عرض جغرافیایی همه ورودیها و خروجیهای مکانیابیشده.
«انتخاب مکان» هر نوع ترکیبی را که با مکان جستجو مرتبط باشد برمیگرداند. اگر مکان جستجوشده در فروشگاه خاصی در مرکز خرید باشد، «انتخاب مکان» این موارد را برمیگرداند: * فروشگاه خاص، ورودیها و خروجیهای آن، و طرح کلی فروشگاه * ساختمان مرکب (مرکز خرید)، ورودیها و خروجیهای آن، و طرح کلی مرکز خرید * محوطه مرکب (مرکز خرید + پارکینگ)، ورودیها و خروجیهای آنها، و طرح کلی کل محوطه
این تصویر هر سه نوع ترکیب را که برگردانده شدهاند نشان میدهد.

این تصویر چندین مکان را در داخل فرودگاه نشان میدهد، با مرز هر دو ساختمان داخل فرودگاه و مرز فرودگاه و همه زمینهای مرتبط با آن.
