अपने 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 में इस्तेमाल किए जाने वाले तरीके जैसा ही है.