نقل البيانات من Directions API (الإصدار القديم) أو Distance Matrix API (الإصدار القديم)

المطوّرون في المنطقة الاقتصادية الأوروبية

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

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

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

تعديل نقاط نهاية REST API

تعديل الرمز البرمجي لاستخدام نقاط نهاية 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 الذي يبلغ 16,384 حرفًا. هذه الميزة ليست ضرورية في Routes API لأنّه يمكن نقل النقاط على المسار في نص طلب REST أو gRPC كإحداثيات خطوط العرض/الطول. للاطّلاع على أمثلة، راجِع مثال HTTP في مستند احتساب مصفوفة مسارات أو تحديد نقطة وسيطة على المسار في مستند تحديد النقاط الوسيطة على المسار.

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

تسرد الجداول التالية المَعلمات في Directions API وDistance Matrix API التي تمت إعادة تسميتها أو تعديلها، أو المَعلمات غير المتوافقة مع إصدار GA. يُرجى تعديل الرمز إذا كنت تستخدم أيًا من هذه المَعلمات.

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

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

يتم تمريرها في نص طلب JSON لبروتوكول HTTP POST computeRoutes أو computeRouteMatrix باستخدام قيم RouteTravelMode (DRIVE أو TWO_WHEELER أو WALK أو TRANSIT أو TRUCK أو BICYCLE لـ computeRoutes) بدلاً من مَعلمة طلب بحث GET لعنوان URL. تمت إضافة إمكانية استخدام TWO_WHEELER وTRANSIT وTRUCK.
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 تتوفّر هذه الميزة لواجهة برمجة التطبيقات Compute Routes فقط. يحتوي على معلومات استجابة الترميز الجغرافي لنقاط المسار المحدّدة كعناوين فقط.
bounds viewport
legs.end_address هذه الميزة غير متوفّرة.

استخدِم أرقام تعريف الأماكن بدلاً من الإحداثيات لتحديد المسارات بدقة عالية. تحتوي أرقام تعريف الأماكن على بيانات تضبط المسار على نقاط الوصول الصحيحة.

  • إذا بدأت بعنوان: استخدِم الإكمال التلقائي للأماكن أو Geocoding API لحلّ المشكلة والحصول على رقم تعريف المكان.
  • إذا بدأت بالإحداثيات: ننصحك باستخدام ميزة البحث عن الوجهات لتوفير موقع جغرافي أكثر فائدة. قد يكون الحصول على عنوان من الإحداثيات أمرًا معقدًا ويؤدي إلى التقاط غير صحيح. لا تعكس Routes API الترميز الجغرافي للإحداثيات إلى عناوين.
legs.start_address هذه الميزة غير متوفّرة.
overview_polyline خطوط متعدّدة
summary description
waypoint_order optimizedIntermediateWaypointIndex