العمل مع عارض شاشة المعلومات الثلاثية الأبعاد

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

عناوين URL للمحتوى

عند عرض مربّعات صور واقعية ثلاثية الأبعاد، تعرض واجهة برمجة التطبيقات Map Tiles API معرّفات الموارد المنتظمة (URI) لمجموعات المربّعات الثانوية. إنّ معرّفات الموارد المنتظمة (URI) لمجموعة المربّعات هذه ليست عناوين URL عادية، بل تتضمّن فقط مكوِّن المسار والمعلَمات. ولا تحتوي هذه الملفات على مفتاح واجهة برمجة التطبيقات المطلوب للسماح بطلبك. للحصول على مزيد من المعلومات، يمكنك الاطّلاع على مواصفات الشاشات الثلاثية الأبعاد.

الطلبات والردود

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

نموذج طلب مجموعة الجذر:

https://tile.googleapis.com/v1/3dtiles/root.json?key=YOUR_API_KEY

نموذج معرّف الموارد المنتظم (URI) لرد مجموعة المربّعات:

 /v1/3dtiles/datasets/CgA/files/UlRPVEYuYnVs.json?session=CIqhrPOFvdHSYg

نماذج من عناوين URL لطلبات المربعات التي تستخدمها برامج العرض:

https://tile.googleapis.com/v1/3dtiles/datasets/CgA/files/UlRPVEYuYnVs.json?session=CIqhrPOFvdHSYg&key=YOUR_API_KEY

https://tile.googleapis.com/v1/3dtiles/datasets/CgA/files/UlRPVEYubm9k.glb?session=CIqhrPOFvdHSYg&key=YOUR_API_KEY

يجب إرفاق أي معلَمات تظهر في معرّف الموارد المنتظم (URI) لمجموعة المربّعات، مع مفتاح واجهة برمجة التطبيقات، عند إنشاء طلبات المربّعات اللاحقة. توفر واجهة برمجة التطبيقات 3D Tiles API المعلَمتين التاليتين:

session
معرّف مضمّن لجلسة تحميل ثلاثية الأبعاد يتم إنشاؤها تلقائيًا بواسطة واجهة برمجة التطبيقات. ويجب أن يتم إرفاقه من خلال العارض عند إنشاء طلبات الفئات اللاحقة.
key
مفتاح واجهة برمجة التطبيقات الذي تم استخدامه للوصول إلى خدمة "الشاشات الثلاثية الأبعاد". يجب إرفاقه بجميع طلبات الفئات اللاحقة.

الإحالات على الشبكة الإعلانية

تعني عملية تحديد المصدر الإقرار بمصدر مربّعات الخرائط، وهي أحد متطلبات استخدام واجهة برمجة التطبيقات هذه، ويشمل ذلك تحديد مصدر علامة Google التجارية (الشعار) بالإضافة إلى تحديد مصدر البيانات. يتوفّر شعار Google لك في صفحة سياسات واجهة برمجة تطبيقات Map Tiles. يتم إرجاع معلومات إحالة البيانات في كل استجابة متجانبة. ابحث عنه في نص الاستجابة، في JSON ضمن asset.copyright.

{
  "asset": {
    "version": "2.0",
    "generator": "draco_decoder",
    "copyright": "Data SIO, NOAA, U.S. Navy, NGA, GEBCO;Landsat / Copernicus"
  }
}

عليك تجميع هذه المعلومات وترتيبها وعرضها في سطر من النص، يكون ذلك عادةً في أسفل العرض. ويتطلّب ذلك تنفيذ الخطوات التالية:

  1. استخرِج جميع معلومات حقوق الطبع والنشر من جميع المربّعات المعروضة.

  2. افصل بين مصادر حقوق الطبع والنشر المتعددة بفاصلة منقوطة.

  3. رتِّب المعلومات استنادًا إلى عدد التكرارات.

  4. اعرض مصادر حقوق الطبع والنشر على الشاشة، مرتَّبة من الأكثر إلى الأقل استخدامًا، على غرار طريقة عرض Google Earth.