अपने 3D टाइल रेंडरर के साथ काम करें

अगर आपको अपने समाधान में तीसरे पक्ष के रेंडरिंग प्रॉडक्ट को शामिल करने में समस्या आ रही है, तो आपको अपना 3D टाइल रेंडरर बनाना पड़ सकता है. इस तरीके के लिए, आपको इन अहम बातों का ध्यान रखना होगा:

कॉन्टेंट के यूआरएल

फ़ोटोरियलिस्टिक 3D टाइल दिखाते समय, Map Tiles API, चाइल्ड टाइलसेट के लिए यूआरआई दिखाता है. ये टाइलसेट यूआरआई, सामान्य यूआरएल नहीं होते. इनमें सिर्फ़ पाथ और पैरामीटर कॉम्पोनेंट शामिल होते हैं. इनमें आपकी एपीआई पासकोड शामिल नहीं होती, जो आपके अनुरोध को अनुमति देने के लिए ज़रूरी है. ज़्यादा जानकारी के लिए, 3D टाइल की खास जानकारी देखें.

अनुरोध और जवाब

यहां फ़ोटोरियलिस्टिक 3D टाइल के अनुरोधों और उनके जवाबों के कुछ उदाहरण दिए गए हैं. Chrome डेवलपर टूल का इस्तेमाल करके, इनकी जांच की जा सकती है.

रूट टाइलसेट के अनुरोध का सैंपल:

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

टाइलसेट के रिस्पॉन्स यूआरआई का सैंपल:

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

रेंडरर के इस्तेमाल किए जाने वाले टाइल अनुरोध यूआरएल के सैंपल:

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
3D लोडिंग सेशन के लिए, पहले से मौजूद आइडेंटिफ़ायर. यह एपीआई की मदद से अपने-आप जनरेट होता है. टाइल के अगले अनुरोध बनाते समय, रेंडरर को इसे अटैच करना होगा.
key
3D टाइल सेवा को ऐक्सेस करने के लिए इस्तेमाल की गई एपीआई कुंजी. आपको इसे टाइल के लिए किए जाने वाले सभी अनुरोधों में अटैच करना होगा.

डिसप्ले एट्रिब्यूशन

एट्रिब्यूशन का मतलब है, मैप टाइल के सोर्स को स्वीकार करना. यह इस एपीआई के इस्तेमाल के लिए ज़रूरी है. इसमें Google ब्रैंड एट्रिब्यूशन (लोगो) के साथ-साथ डेटा एट्रिब्यूशन भी शामिल है. Google का लोगो, Map Tiles API की नीतियां पेज पर उपलब्ध है. डेटा एट्रिब्यूशन की जानकारी, हर टाइल के जवाब में दी जाती है. इसे asset, copyright में, glTF टाइल में देखें.

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

आपको इस जानकारी को टेक्स्ट की लाइन में इकट्ठा, क्रम से लगाना, और दिखाना होगा. आम तौर पर, इसे रेंडरिंग के सबसे नीचे दिखाया जाता है. इसके लिए, यह तरीका अपनाएं:

  1. व्यू में मौजूद सभी टाइल से, कॉपीराइट की सारी जानकारी निकालें.

  2. कॉपीराइट के एक से ज़्यादा सोर्स को सेमीकोलन लगाकर अलग करें.

  3. गड़बड़ी की संख्या के आधार पर जानकारी को क्रम से लगाएं.

  4. कॉपीराइट के सोर्स को स्क्रीन पर दिखाएं. सबसे ज़्यादा से कम होने के हिसाब से क्रम में लगाएं. ठीक उसी तरह जैसे Google Earth करता है.