يمكنك العثور على نقاط الاستلام لموقع جغرافي معيّن.
طلب HTTP
POST https://locationselection.googleapis.com/v1beta:findPickupPointsForLocation
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
تمثيل JSON |
---|
{ "localizationPreferences": { object ( |
الحقول | |
---|---|
localizationPreferences |
مطلوبة. التفضيلات المستخدمة لأقلمة النصوص في الرد، مثل الاسم والعنوان. |
searchLocation |
مطلوبة. الموقع الجغرافي المطلوب استخدامه للبحث في نقاط الاستلام واحتساب المسافات والوقت المقدّر للوصول إلى نقاط الاستلام |
orderBy |
مطلوبة. ترتيب للاستخدام عند عرض النتائج. |
destination |
موقع الوجهة المقصود للعميل. يتم ضبطها عند طلب نقاط الاستلام مرتّبة حسب الوقت المقدّر للوصول (ETA) للوجهة. |
maxResults |
مطلوبة. الحد الأقصى لعدد النتائج التي سيتم عرضها. يجب أن يكون أكبر من 0. |
travelModes[] |
مطلوبة. لا يتم إرجاع سوى نقاط الاستلام التي تسمح باستخدام وسيلة واحدة على الأقل من وسائل النقل المحدّدة. وسائل السفر المتوافقة: DRIVING وTWO_WHEELER. يجب تحديد وضع واحد على الأقل. |
computeWalkingEta |
إذا كانت القيمة صحيحة، يتم احتساب الوقت المقدّر للوصول أثناء المشي من موقع البحث إلى نقطة الاستلام. |
computeDrivingEta |
إذا تم تحديد true وdestination، يتم احتساب الوقت المقدر للوصول من نقطة الاستلام إلى الوجهة. |
wifiAccessPoints[] |
نقاط وصول WiFi حول موقع البحث يتم استخدامه لتقديم نتائج بحث ذات جودة أعلى. |
نص الاستجابة
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
العثور على نقاط الاستلام لرسالة الردّ على الموقع الجغرافي
تمثيل JSON |
---|
{ "placePickupPointResults": [ { object ( |
الحقول | |
---|---|
placePickupPointResults[] |
نقاط الاستلام القريبة مع رقم تعريف المكان المرتبط يتم ترتيب النتائج الواردة في هذه القائمة وفقًا للمعايير الواردة في الطلب. قد يتجاوز عدد النتائج في 'place PickupPointResults' عدد النتائج في 'placeResults'. |
placeResults[] |
تفاصيل عن الأماكن المرتبطة بنقاط الاستلام القريبة لم يتم ترتيب النتائج في هذه القائمة. |
PlacePickupPointResult
نقاط الاستلام مع رقم تعريف المكان المرتبط بها
تمثيل JSON |
---|
{
"pickupPointResult": {
object ( |
الحقول | |
---|---|
pickupPointResult |
تفاصيل عن نقطة الاستلام يجب إدخال بيانات هذا الحقل. |
associatedPlaceId |
رقم تعريف المكان المرتبط بالمكان. |