يصف هذا الدليل طريقة نقل التطبيقات التي تستخدم واجهة برمجة تطبيقات الاتجاهات أو واجهة برمجة تطبيقات مصفوفة المسافة إلى استخدام واجهة برمجة تطبيقات Routes. لمعرفة تفاصيل حول Routes API، يمكنك الاطّلاع على مقالة نظرة عامة على المنتجات.
تعديل نقاط نهاية REST API
تعديل الرمز لاستخدام نقاط نهاية 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
باستخدام واجهة برمجة التطبيقات Directions API وواجهة برمجة تطبيقات مصفوفة المسافة، يمكنك تمرير خصائص الضبط كمعلَمات عناوين URL إلى طلب HTTP GET
. على سبيل المثال، بالنسبة
إلى واجهة برمجة تطبيقات الاتجاهات:
https://maps.googleapis.com/maps/api/directions/outputFormat?parameters
باستخدام Routes API، يمكنك تمرير المَعلمات في نص الطلب أو في العناوين
كجزء من طلب HTTP POST
. للاطّلاع على أمثلة، يُرجى مراجعة ما يلي:
تحويل نقاط الطرق ذات الخطوط المتعددة إلى نقاط مسار للمواقع
تتوفّر ميزة تحديد نقاط الطريق كخطوط متعددة مشفّرة في واجهة برمجة التطبيقات للاتجاهات لتتوافق مع عدد كبير من نقاط الطريق في حد عنوان URL البالغ 16384 حرفًا. هذه الميزة ليست ضرورية في Routes API لأنه يمكن إرسال نقاط الطريق في نص طلب RST أو gRPC كإحداثيات لخطوط الطول/العرض. للحصول على أمثلة، راجِع مثال HTTP في مستند حساب مصفوفة مسار أو تحديد نقطة طريق وسيطة في مستند تحديد نقاط الطريق الوسيطة.
تحويل المعلمات
تسرد الجداول التالية المعلمات في واجهة برمجة التطبيقات للاتجاهات وواجهة برمجة التطبيقات لمصفوفة المسافة التي تمت إعادة تسميتها أو تعديلها، أو المعلمات غير المتوافقة في إصدار "إحصاءات Google". عدِّل رمزك إذا كنت تستخدم أيًا من هذه المَعلمات.
طلب الإحالات الناجحة للمَعلمات
مَعلمة مصفوفة الاتجاهات أو الاتجاهات | معلمة Routes API | Notes |
---|---|---|
alternatives |
computeAlternativeRoutes |
|
arrival_time |
arrivalTime |
تتوفّر هذه الميزة في وضع TRANSIT فقط، وليس في وقت
departureTime نفسه. |
avoid |
routeModifiers |
|
departure_time |
departureTime |
لا يمكن استخدامهما في الوقت نفسه مع arrivalTime . |
language |
languageCode |
يتوفّر هذا الخيار لمسارات الحوسبة فقط. |
mode |
travelMode |
تمت إضافة معلومات عن |
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 | Notes |
---|---|---|
copyrights |
غير مُدرج في الرد. وعليك تضمين العبارة التالية عند عرض النتائج للمستخدمين:
مثلاً:
|
|
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 |