Method: searchAlongRoute

البحث عن أماكن على طول مسار السفر

طلب HTTP

POST https://mapstools.googleapis.com/v1alpha:searchAlongRoute

يستخدِم عنوان URL بنية تحويل الترميز إلى gRPC.

نص الطلب

يتضمن نص الطلب بيانات بالبنية التالية:

تمثيل JSON 
{
  "textQuery": string,
  "languageCode": string,
  "regionCode": string,
  "routingPreference": enum (RoutingPreference),
  "includeExtendedDetails": boolean,
  "travelMode": enum (RouteTravelMode),

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "encodedPolyline": string,
  "retrievalToken": string,
  "routeEndpoints": {
    object (RouteEndpoints)
  }
  // End of mutually exclusive fields.
}
الحقول
textQuery

string

الحقل مطلوب. طلب بحث بلغة طبيعية (مثل "شواحن المركبات الكهربائية" أو "قهوة")
languageCode

string

اختياريّ. لغة الملخّص وتفاصيل المكان القيمة التلقائية هي "en-US".
regionCode

string

اختياريّ. رمز البلد/المنطقة (CLDR) للموقع الجغرافي (مثل "US")
routingPreference

enum (RoutingPreference)

اختياريّ. خيار توجيه اختياري يحدّد كيفية استخدام بيانات حركة المرور القيمة التلقائية هي TRAFFIC_UNAWARE.
includeExtendedDetails

boolean

اختياريّ. يتضمّن تفاصيل المكان الموسّعة في الردّ.

اضبط هذا الحقل على true عندما يتطلّب طلب المستخدم إحصاءات نوعية غنية أو ديناميكيات في الوقت الفعلي أو سمات كيانات متخصّصة: - المراجعات النوعية وآراء العملاء وملاحظاتهم. - عروض معيّنة، مثل أصناف قائمة الطعام أو الأطباق أو الأطعمة الخاصة أو المشروبات أو الميزات البارزة للنشاط التجاري - الأجواء النوعية أو الديكور الداخلي أو الجماليات أو الأجواء أو الحالة المزاجية. - بيانات في الوقت الفعلي ومواصفات المنشآت المتخصّصة وسياسات/نصائح الزوّار وأوقات الانتظار

اترك القيمة false (القيمة التلقائية) لعمليات البحث العادية عن الأماكن (مثل أنواع المأكولات وأنواع المتاجر) وعمليات البحث عن المواقع الجغرافية/العناوين ومعلومات الاتصال وساعات العمل والبيانات الوصفية/وسائل الراحة العادية.

قد يؤدي تفعيل هذا الحقل إلى زيادة وقت الاستجابة.
travelMode

enum (RouteTravelMode)

اختياريّ. تحدّد هذه المَعلمة وسيلة النقل المستخدَمة لحساب المسار والمسارات البديلة. القيمة التلقائية هي DRIVE. لا يتوفّر كل من WALK وBICYCLE إلا مع routeEndpoints. ‫"TRANSIT" غير متاح.
مواصفات المسار: إما مسار حالي أو رمز مميّز للمسار أو نقاط نهاية المصدر/الوجهة في ما يلي قائمة بالحقول التي يستبعد كلّ منها الآخر. سيتم ضبط حقل واحد على الأكثر في الردّ:
encodedPolyline

string

سلسلة خطوط متعدّدة مرمّزة تمثّل المسار يُرجى الاطّلاع على https://developers.google.com/maps/documentation/utilities/polylinealgorithm
retrievalToken

string

رمز مميّز للاسترداد تم إرجاعه من طلب v1alpha.computeRoutes سابق يمثّل المسار.
routeEndpoints

object (RouteEndpoints)

نقاط نهاية المسار الصريحة (نقطة الانطلاق والوجهة)
نهاية الحقول التي يستبعد كلّ منها الآخر

نص الاستجابة

إذا كانت الاستجابة ناجحة، سيحتوي نصها على مثال SearchAlongRouteResponse.

نطاقات الأذونات

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/maps-platform.mapstools