نقل البيانات من واجهة برمجة التطبيقات Directions API أو واجهة برمجة التطبيقات لمصفوفة المسافة

يوضّح هذا الدليل كيفية نقل التطبيقات التي تستخدم أيًا مما يلي: واجهة برمجة تطبيقات الاتجاهات أو واجهة برمجة تطبيقات مصفوفة المسافة لاستخدام واجهة برمجة تطبيقات Routes. لمعرفة التفاصيل حول Routes API، يمكنك الاطّلاع على المنتج نظرة عامة.

تعديل نقاط نهاية واجهة برمجة التطبيقات REST

تعديل الرمز لاستخدام نقاط نهاية Routes API الجديدة

من Directions API

واجهة برمجة التطبيقات للاتجاهات https://maps.googleapis.com/maps/api/directions/outputFormat?parameters
Routes API https://routes.googleapis.com/directions/v2:computeRoutes

من واجهة برمجة تطبيقات تباعد المسافة

واجهة برمجة التطبيقات لمصفوفة المسافة https://maps.googleapis.com/maps/api/distancematrix/outputFormat?parameters
Routes API https://routes.googleapis.com/distanceMatrix/v2:computeRouteMatrix

تحويل مَعلمات عناوين URL لاستخدام نص طلب HTTPS

باستخدام واجهة برمجة تطبيقات الاتجاهات وواجهة برمجة تطبيقات مصفوفة المسافة، يمكنك تمرير خصائص الإعداد كمعلَمات عناوين URL إلى طلب HTTP GET. بالنسبة على سبيل المثال، بالنسبة إلى Directions API:

https://maps.googleapis.com/maps/api/directions/outputFormat?parameters

باستخدام Routes API، يمكنك تمرير المَعلمات في نص الطلب أو في العناوين. كجزء من طلب HTTP POST. للاطّلاع على أمثلة، يُرجى مراجعة ما يلي:

تحويل نقاط الطرق ذات الخطوط المتعددة إلى نقاط مسار للمواقع

تتوفّر إمكانية تحديد نقاط الطريق كخطوط متعددة مرمّزة في واجهة برمجة تطبيقات الاتجاهات لتتناسب مع عدد كبير عدد نقاط الطريق في حد عنوان URL البالغ 16384 حرفًا. هذه الميزة لا اللازمة في Routes API لأنّه يمكن إرسال نقاط الطرق في نص طلب REST أو gRPC كإحداثيات لخطوط الطول/العرض. على سبيل المثال، اطّلِع على مثال على HTTP في مستند حساب مصفوفة مسارات، أو تحديد نقطة طريق وسيطة في مستند تحديد نقاط الطريق الوسيطة.

تحويل المعلمات

تسرد الجداول التالية المَعلمات في واجهتَي برمجة التطبيقات Direction API وDistance Matrix API التي تمت تسميتها أو تعديلها، أو المَعلمات غير المتوافقة مع إصدار "إحصاءات Google". عدِّل رمزك إذا كنت تستخدم أيًا من هذه المَعلمات.

طلب الإحالات الناجحة للمَعلمات

مَعلمة مصفوفة الاتجاهات أو الاتجاهات معلمة Routes API ملاحظات
alternatives computeAlternativeRoutes
arrival_time arrivalTime متوفّر في وضع TRANSIT فقط، وليس في الوضع نفسه مرّة إلى departureTime.
avoid routeModifiers
departure_time departureTime لا يمكن استخدامهما في الوقت نفسه مع arrivalTime.
language languageCode يتوفّر هذا الخيار لمسارات الحوسبة فقط.
mode travelMode

تمت إضافة إمكانية استخدام TWO_WHEELER و TRANSIT.

region regionCode
traffic_model trafficModel مزيد من المعلومات
transit_mode "travelMode": "TRANSIT" في Directions API، في مسار النقل العام، يُعتبر كل جزء من رحلة باستخدام طريقة النقل نفسها (على سبيل المثال، المشي أو النقل العام) خطوة واحدة، وتكون الاتجاهات الفردية لطريقة النقل هذه في الخطوات الفرعية. في المقابل، في واجهة برمجة التطبيقات Routes API، تكون الخطوات بشكلٍ منتظم عبارة عن إرشادات تنقّل واحدة لجميع أنواع السفر. لذا فإن كل تعليمات التنقل هي خطوة. بالنسبة إلى الخطوات المتعددة في وضع سفر واحد، توفر Routes API بيانات التعريف التي تحتوي على ملخص لخطوات وضع السفر هذا، `stepsOverview`. لطلب هذه البيانات الوصفية، يمكنك استخدام قناع الحقل "routes.legs.stepsOverview". مزيد من المعلومات
transit_routing_preference transitRoutingPreference مزيد من المعلومات
units لا تتوفّر لمصفوفة المسارات.
waypoints intermediates تمت إزالة التوافق مع الخطوط المتعددة المرمّزة.
optimize=true لنقاط الطريق "optimizeWaypointOrder": "true" مزيد من المعلومات

الإحالات الناجحة لمَعلمات الاستجابة

مَعلمة مصفوفة الاتجاهات أو الاتجاهات معلمة Routes API ملاحظات
copyrights

غير مُدرج في الرد. يجب تضمين ما يلي: المستخدم عند عرض النتائج للمستخدمين:

Powered by Google, ©YEAR Google

على سبيل المثال:

Powered by Google, ©2022 Google

distance distanceMeters لا تتوفّر المسافة إلا بالأمتار.
duration_in_traffic duration تمت الإزالة في Routes API، واستخدِم duration.
status هذه الميزة غير متوفّرة. استخدِم رموز استجابة HTTP لتحديد الأخطاء التي تم الإبلاغ عنها من خلال واجهة برمجة التطبيقات. يُرجى الاطّلاع على معالجة أخطاء الطلبات. لمزيد من المعلومات.
geocoded_waypoints geocoding_results يتوفّر هذا الخيار لمسارات الحوسبة فقط. يحتوي على معلومات استجابة الترميز الجغرافي فقط لنقاط الطرق المحددة كعناوين.
bounds viewport
legs.end_address هذه الميزة غير متوفّرة.
legs.start_address هذه الميزة غير متوفّرة.
overview_polyline خطوط متعدّدة
summary description
waypoint_order optimizedIntermediateWaypointIndex