إذا لم تتمكّن من دمج منتج عرض تابع لجهة خارجية في الحلّ الذي تقدّمه، قد تحتاج إلى إنشاء عارض 3D Tiles خاص بك. يتطلب هذا النهج مراعاة العوامل المهمة التالية:
عناوين URL للمحتوى
عند عرض مربّعات ثلاثية الأبعاد لصور واقعية، تعرض واجهة برمجة التطبيقات Map Tiles معرّفات الموارد المنتظمة (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- مفتاح واجهة برمجة التطبيقات الذي استخدمته للوصول إلى خدمة 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"
}
}
يجب تجميع هذه المعلومات وفرزها وعرضها في سطر نصي، عادةً في أسفل العرض. يتطلّب ذلك اتّباع الخطوات التالية:
استخرِج جميع معلومات حقوق الطبع والنشر من جميع المربّعات المعروضة.
افصل بين مصادر حقوق الطبع والنشر المتعددة باستخدام فاصلة منقوطة.
رتِّب المعلومات استنادًا إلى عدد مرات التكرار.
اعرض مصادر حقوق الطبع والنشر على الشاشة، مرتّبة من الأكثر تكرارًا إلى الأقل، على غرار الطريقة التي يتّبعها Google Earth.