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

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

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