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

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

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

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

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

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

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

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

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

  2. कॉपीराइट वाले कई सोर्स को सेमीकोलन लगाकर अलग करें.

  3. जानकारी को संख्या के हिसाब से क्रम में लगाएं.

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