نقل البيانات من إصدار "معاينة"

بالنسبة إلى مطوّري البرامج في المنطقة الاقتصادية الأوروبية (EEA)

تم إطلاق Routes API كإصدار تجريبي متاح للجميع (مرحلة ما قبل التوفّر للجمهور العام) في سبتمبر 2022. تخضع عروض مرحلة ما قبل التوفّر للجمهور العام لبنود الخدمة المحدّدة في منصة خرائط Google بنود. لمزيد من المعلومات، يُرجى الاطّلاع على أوصاف مراحل الإطلاق.

يوضِّح هذا القسم كيفية نقل تطبيق من الإصدار التجريبي المتاح للجميع إلى الإصدار المتاح للجمهور العام.

الميزات الجديدة التي تمت إضافتها إلى الإصدار المتاح للجمهور العام

يضيف الإصدار المتاح للجمهور العام الميزات الجديدة التالية التي لم تكن مضمّنة في الإصدار التجريبي المتاح للجميع:

  • بالإضافة إلى معرّفات الأماكن وإحداثيات خطوط الطول والعرض، يمكنك الآن تحديد موقع جغرافي في الإصدار المتاح للجمهور العام باستخدام:

    • سلاسل العناوين ("شيكاغو، إلينوي" أو "داروين، الإقليم الشمالي، أستراليا")

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

      بالإضافة إلى ذلك، تمت إضافة دعم مَعلمة الطلب regionCode، ما يتيح لك تحديد عرض نتائج تحديد الموقع الجغرافي لمنطقة جغرافية معيّنة.

    • Plus Codes

      Plus Codes هي بمثابة عناوين الشوارع، لكنها مخصّصة للأشخاص أو الأماكن التي ليس لها عنوان فعلي. وبدلاً من العناوين التي تحتوي على أسماء الشوارع وأرقامها، تستند Plus Codes إلى خطوط الطول والعرض وتظهر كأرقام وحروف.

  • تحتوي الآن استجابة compute routes على المصفوفة geocodingResults. بالنسبة إلى كل موقع جغرافي في الطلب (المصدر، الوجهة، أو نقطة المرور الوسيطة) تم تحديده كـ سلسلة عنوان أو رمز موقع مفتوح، تبحث واجهة برمجة التطبيقات عن معرّف المكان. يحتوي كل عنصر من هذه المصفوفة على معرّف المكان المقابل لموقع جغرافي، بالإضافة إلى بيانات وصفية إضافية عن الموقع الجغرافي. يتم تجاهل المواقع الجغرافية في الطلب التي تم تحديدها كمعرّف مكان أو كإحداثيات خطوط الطول والعرض.

التغييرات على الميزات الحالية في الإصدار التجريبي المتاح للجميع

عليك الآن تفعيل الميزات التالية بشكل صريح في الإصدار المتاح للجمهور العام من خلال إضافة الحقل الجديد extraComputations إلى الطلب:

في الإصدار التجريبي المتاح للجميع، كنت تستخدم قناع حقل لتحديد عرض معلومات هذه الميزات في الاستجابة. عليك الآن تنفيذ ما يلي:

  • ضبط مَعلمة الطلب الجديدة للمصفوفة extraComputations لتفعيل هذه الميزات
  • ضبط قناع حقل لتحديد عرض المعلومات في الاستجابة

ما هي المعلومات التي يجب معرفتها؟

لن يتم تضمين الحقول التالية في استجابات computeRouteMatrix ما لم يتم تفعيلها بشكل صريح من خلال ضبط extraComputations:

  • travelAdvisory.tollInfo (معلومات رسوم العبور)

لن يتم تضمين الحقول التالية في استجابات computeRoutes ما لم يتم تفعيلها بشكل صريح من خلال ضبط extraComputations:

  • routes.legs.travelAdvisory.tollInfo(معلومات رسوم العبور)
  • routes.travelAdvisory.tollInfo(معلومات رسوم العبور)
  • routes.travelAdvisory.fuelConsumptionMicroliters(استهلاك الوقود)
  • routes.travelAdvisory.speedReadingIntervals(كثافة حركة المرور على خط متعدد)
  • routes.legs.travelAdvisory.speedReadingIntervals(كثافة حركة المرور على خط متعدد)

ما هو الإجراء الواجب اتّخاذه؟

لتلقّي حقول الاستجابة لمعلومات رسوم العبور أو استهلاك الوقود أو كثافة حركة المرور على خط متعدد، عليك ضبط حقل مصفوفة الطلب الجديد extraComputations لتضمين قيمة واحدة أو أكثر من القيم التالية: