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

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

أفضل الممارسات المتعلّقة بالفوترة لنقل البيانات

تنطبق هذه الإرشادات إذا كان استخدام واجهة برمجة التطبيقات مرتفعًا بما يكفي للتصعيد إلى الأسعار من المستوى الثاني. عند نقل البيانات إلى إصدار أحدث من واجهة برمجة التطبيقات، يتم أيضًا تحصيل رسوم منك مقابل رمز تخزين تعريفي مختلف. لتجنُّب تكاليف متزايدة خلال شهر عملية النقل، ننصحك بالتبديل إلى واجهات برمجة التطبيقات الجديدة في مرحلة الإنتاج في أقرب وقت ممكن من بداية الشهر. سيضمن لك ذلك الوصول إلى مستويات الأسعار الشهرية الأكثر فعالية من حيث التكلفة خلال شهر نقل البيانات. للحصول على معلومات عن فئات الأسعار، يُرجى الاطّلاع على صفحة الأسعار والأسئلة الشائعة حول الأسعار.

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

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

من Directions API

Directions API https://maps.googleapis.com/maps/api/directions/outputFormat?parameters
Routes API https://routes.googleapis.com/directions/v2:computeRoutes

من Distance Matrix API

Distance Matrix API https://maps.googleapis.com/maps/api/distancematrix/outputFormat?parameters
Routes API https://routes.googleapis.com/distanceMatrix/v2:computeRouteMatrix

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

باستخدام Directions API وDistance Matrix API، يمكنك تمرير سمات الإعدادات كمَعلمات عناوين URL إلى طلب HTTP GET. على سبيل المثال، بالنسبة إلى Directions API:

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

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

تحويل نقاط الطريق المشفَّرة بخطوط متعددة إلى نقاط طريق مواقع جغرافية

يتوفّر تحديد نقاط الالتفاف كخطوط متعددة مُشفَّرة في Directions API لاستيعاب عددٍ كبيرٍ من نقاط الالتفاف ضمن الحد الأقصى المسموح به لعنوان 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 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