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

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

عناوين 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

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

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

مصادر الإحالات على الشبكة الإعلانية

يشير تحديد المصدر إلى الإقرار بمصدر مربّعات الخريطة، وهو شرط لاستخدام واجهة برمجة التطبيقات هذه، ويشمل ذلك تحديد مصدر العلامة التجارية لشركة Google (الشعار) بالإضافة إلى تحديد مصدر البيانات. يتوفر شعار Google لك على سياسات واجهة برمجة تطبيقات الخرائط (Map Tiles API). البيانات يتم عرض معلومات الإحالة في كل رد مقسّم. ابحث عنه في شريحة glTF، ضمن 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