अपने 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 टाइल API, ये दो पैरामीटर उपलब्ध कराता है:

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

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

एट्रिब्यूशन का मतलब है, मैप टाइल के सोर्स की पुष्टि करना. इस एपीआई का इस्तेमाल करने के लिए, यह ज़रूरी है. इसमें Google के ब्रैंड एट्रिब्यूशन (लोगो) के साथ-साथ, डेटा एट्रिब्यूशन भी शामिल है. Google का लोगो, Map Tiles API की नीतियों वाले पेज पर उपलब्ध है. डेटा एट्रिब्यूशन की जानकारी, टाइल के हर जवाब में दिखती है. इसे glTF टाइल में, under 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 में दिखने वाले क्रम जैसा होना चाहिए.