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

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

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

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

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

يضيف إصدار GA الميزات الجديدة التالية التي لم يتم تضمينها في الإصدار الأوّلي:

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

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

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

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

    • رموز Plus

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

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

التغييرات على ميزات "المعاينة" الحالية

يجب الآن تفعيل الميزات التالية بشكل صريح في "إحصاءات Google" من خلال إضافة الحقل الجديد 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، لتضمين قيمة واحدة أو أكثر من القيم التالية: