अपने 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 करता है.