مرجع سريع لواجهة برمجة التطبيقات Routes API

‫Routes API هي خدمة ويب تتضمّن طريقتَين: تعرض طريقة Compute Routes مسارًا بين موقعَين جغرافيَّين مع نقاط وسيطة اختيارية على المسار، وتعرض طريقة Compute Route Matrix مسافة السفر والوقت لمجموعات من نقاط الانطلاق والوجهات (ما يصل إلى 625 عنصر مسار).

‫Routes API: حقائق رئيسية

  • المنتج: Routes API
  • تُعرف أيضًا باسم: الإصدار 2 من Routes API وCompute Routes وCompute Route Matrix
  • الفئة: المسارات
  • المنصة: خدمة ويب (REST)
  • يتم تشغيله على: الخادم (رمز الخلفية)
  • مرحلة الإطلاق: GA
  • Lifecycle: نشط
  • نظرة عامة: نظرة عامة على Routes API
  • نطاق التوفّر الجغرافي: على مستوى العالم تقتصر ميزات تحديد مسارات الدراجات النارية والمسارات الصديقة للبيئة واحتساب رسوم العبور على البلدان والمدن التي تتوفّر فيها هذه الميزات، ولا تتوفّر في الأقاليم التابعة التي لها رمز CLDR خاص بها ما لم تكن مدرَجة. بالنسبة إلى عناوين إرسال الفواتير في المنطقة الاقتصادية الأوروبية، تحظر بنود المنطقة الاقتصادية الأوروبية على الرابط https://developers.google.com/maps/comms/eea/routes استخدام أوصاف المسارات أو خطواتها مع أي خريطة. (تفاصيل التغطية)

‫Routes API: حالات الاستخدام

استخدِم Routes API في الحالات التالية:

  • تحتاج إلى مسار بين نقطة انطلاق ووجهة، مع نقاط على المسار وسيطة اختيارية، للقيادة أو المشي أو ركوب الدراجات أو الدراجات النارية أو وسائل النقل العام.
  • تحتاج إلى مسافات وأوقات السفر للعديد من أزواج نقاط الانطلاق والوجهات في طلب واحد (ما يصل إلى 625 عنصرًا).
  • تحتاج إلى تقديرات رسوم العبور (في مدن محدّدة) أو مسارات صديقة للبيئة (في مناطق محدّدة) أو خطوط متعدّدة تراعي حركة المرور أو مسارات للمركبات الكبيرة (تتوفّر بكمية محدودة).
  • إذا كنت تنقل تطبيق خادم من واجهة برمجة التطبيقات Directions API أو Distance Matrix API القديمة

لا تستخدِم Routes API في الحالات التالية:

‫Routes API: الإعداد

حِزم Routes API الرسمية:

  • npm: @googlemaps/routing
  • pypi: google-maps-routing
  • go: cloud.google.com/go/maps
  • maven: com.google.maps:google-maps-routing

‫Routes API: الأخطاء الشائعة

  • المشكلة: لا تتوفّر قائمة تلقائية بالحقول التي يتم عرضها، وتؤدي الطلبات التي لا تتضمّن قناع حقل (العنوان X-Goog-FieldMask أو المَعلمة $fields) إلى ظهور خطأ. الحلّ: أرسِل دائمًا قناع حقل يسرد حقول الاستجابة التي تحتاج إليها. يُرجى الاطّلاع على /maps/documentation/routes/choose_fields.
  • المشكلة: يؤدي استخدام قناع حقل حرف البدل (*) في مرحلة الإنتاج إلى زيادة التكلفة ووقت الاستجابة، ويمكن أن ترتفع التكلفة بشكل غير متوقّع عند إضافة ميزات متقدّمة جديدة إلى الردّ. الحلّ: استخدِم * فقط أثناء التطوير، واطلب في مرحلة الإنتاج الحقول التي تحتاج إليها فقط. يُرجى الاطّلاع على /maps/documentation/routes/choose_fields.
  • المشكلة: لا يتم عرض معلومات رسوم العبور واستهلاك الوقود بمجرد إضافتها إلى قناع الحقل، لأنّه يجب تفعيلها صراحةً منذ الإصدار العلني. الحلّ: أضِف مصفوفة extraComputations (على سبيل المثال TOLLS وFUEL_CONSUMPTION) إلى الطلب بالإضافة إلى قناع الحقل. يُرجى الاطّلاع على /maps/documentation/routes/migrate-routes-preview.
  • المشكلة: تسمح واجهة برمجة التطبيقات Compute Route Matrix باستخدام 625 عنصرًا، ولكنّها تسمح باستخدام 100 عنصر فقط عندما تكون قيمة routingPreference هي TRAFFIC_AWARE_OPTIMAL. الحلّ: يجب أن يكون عدد نقاط الانطلاق × الوجهات أقل من أو يساوي 100 عند استخدام TRAFFIC_AWARE_OPTIMAL، أو يمكنك تقسيم الطلب. يُرجى الاطّلاع على /maps/documentation/routes/compute_route_matrix.

الإجراءات التي تتيح Routes API تنفيذها

يمكنك الاطّلاع على الأدلة المرتبطة أدناه لكل مهمة، أو المقارنة بين المنتجات في مستكشف الإمكانات.