الانتقال

الانتقال من تكامل الارتفاع في Google Maps Platform

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

تقبل Elevation API من Google زوج إحداثيات واحدًا أو أكثر وتُرجع قيمة elevation بالأمتار مع رقم resolution يصف دقة عينة البيانات الأساسية. وهي استجابة موجزة لا تتطلب تحليلًا كثيرًا، مما يُبقي الترحيل نفسه محدود النطاق نسبيًا رغم تغيّر مصدر البيانات الأساسي.

تشغّل My Geocode الارتفاع كنقطة نهاية تعمل بالكامل بشكل طلب واستجابة مباشر: أرسل إحداثية، واحصل على ارتفاع سطح الأرض بالأمتار. ولأن هذا من الاستعلامات التي يمكن فيها وصف الإجابات الحقيقية مباشرة وليس شكل الاستجابة فقط، فإن اختبار هذا الترحيل مقابل نقاط مرجعية معروفة، مثل قمة جبل محددة أو موقع ساحلي عند مستوى سطح البحر، طريقة معقولة لبناء الثقة قبل تحويل حركة مرور الإنتاج. والتفاصيل متاحة في /docs/elevation-lookup/.

بعض الأمور التي تستحق التحقق تحديدًا في هذا الانتقال:

  • ما إذا كان كودك يعتمد على حقل resolution من Google لأي غرض يتجاوز العرض، لأن رقم الدقة يصف دقة أخذ العينات بشكل مختلف بين مصادر بيانات الارتفاع، وأي منطق لاحق يعتمد على قيمة دقة محددة يستحق المراجعة
  • ما إذا كان الاستعلام عن الارتفاع يتم على دفعات (إحداثيات كثيرة في استدعاء واحد) أو بشكل فردي، لأن أشكال الطلبات المجمّعة تختلف بين المزودين وتستحق الاختبار بأحجام الدفعات التي يستخدمها تطبيقك فعلًا
  • ما إذا كان الارتفاع يُستدعى من كود على جانب العميل مباشرة، وهذه لحظة معقولة لنقل الاستدعاء إلى جانب الخادم بغض النظر عن المزود الوجهة

تستخدم المصادقة مفتاحًا يُرسَل في X-API-Key، أو Authorization: Bearer، أو عبر مصادقة HTTP Basic، أو كمعامل في الاستعلام. وهناك 2,500 طلب مجاني يوميًا دون أي مفتاح على الإطلاق، و2,500 طلب مجاني إضافي لكل مفتاح يوميًا يُحتسب لكل شبكة، ثم رصيد مسبق الدفع بسعر 0.0001 € لكل طلب أو مفتاح Unlimited بسعر 50 € شهريًا بعد ذلك، بالسعر نفسه لكل نقطة نهاية أخرى على المنصة.

الإضافات الاختيارية التي تتجاوز الارتفاع نفسه، مثل تفاصيل تهديدات IP ومعلومات الشبكة المتعلقة بأجزاء أخرى من التطبيق، متاحة على المضيفين المتوافقين عبر mg_extras=1، لكن في ترحيل يقتصر على الارتفاع مثل هذا، تكون نقطة النهاية المستقلة عمومًا الخيار الأبسط والأكثر مباشرة. ونقل الارتفاع وحده، قبل ترحيل أكبر للترميز الجغرافي، طريقة منخفضة المخاطر لبدء تقليل الاعتماد على حساب واحد دون الالتزام بمشروع أكبر على الفور.