इस प्रोजेक्ट के बारे में

jpmap_terrain एक फ्रंट-एंड प्रोजेक्ट है जो जापान के भौगोलिक संस्थान (GSI) टाइल ऊंचाई डेटा के आधार पर Babylon.js का उपयोग करके 3D इलाके का प्रतिनिधित्व करता है। इसे TypeScript में लागू किया गया है और इसे npm पैकेज jpmap-terrain के रूप में ESM और टाइप डेफिनिशन फाइलों (.d.ts) के साथ वितरित किया गया है (@babylonjs/core एक peerDependency है)। इसमें दो मुख्य सार्वजनिक API हैं। पहला, JpmapTerrain, किसी भी DOM तत्व पर माउंट करके 3D इलाके का व्यूअर एम्बेड करता है, जिसमें WebGPU/WebGL2 इंजन चयन, अक्षांश-देशांतर, ऊंचाई,方位角 (azimuth), और झुकाव (elevation) का निर्धारण, flyTo के माध्यम से कैमरा मूवमेंट, और कंपास डिस्प्ले स्विचिंग जैसी सुविधाएं शामिल हैं। मानचित्र प्रकार के रूप में मानक मानचित्र और हवाई तस्वीरों के बीच स्विच किया जा सकता है। दूसरा, JpmapDiorama, एक API है जो इलाके को हाथ के आकार के वर्गाकार "हाकोनिवा" (मिनीएचर गार्डन) के रूप में प्रदर्शित करता है, जो मानक वेब ब्राउज़र और WebXR (immersive-ar) सत्र दोनों का समर्थन करता है, जिससे AR-सक्षम वातावरण में AR सत्र में प्रवेश करना संभव होता है। डेमो पोर्टल में 17 डेमो शामिल हैं, जिनमें 3D इलाके का व्यूअर, टाइम-लैप्स (सूर्य की स्थिति और छाया एनीमेशन), ज़ूम लूप, माउंट फुजी शिखर का चक्कर, पॉलीगॉन/सर्कल API सत्यापन, दूरी माप, QGroundControl .plan फ़ाइल व्यूअर, GPX व्यूअर (सांख्यिकी और ऊंचाई ग्राफ के साथ), 3D मॉडल प्लेसमेंट, अवतार एनीमेशन, Boids भीड़ सिमुलेशन, फ़्लाइट डेमो, Havok भौतिकी का उपयोग करने वाला Artillery बैटल गेम, ग्लोब इलाके, और हाकोनिवा डियोरामा शामिल हैं। तकनीकी स्टैक में TypeScript / Babylon.js / Vite (डेमो के लिए) / tsdown (लाइब्रेरी बिल्ड के लिए) / Playwright (Visual Regression Test) / Vitest (यूनिट टेस्ट) शामिल हैं। डेवलपमेंट सर्वर हॉट-रीलोड के साथ शुरू होता है, और Docker/Nginx के माध्यम से डेमो साइट वितरण कॉन्फ़िगरेशन भी प्रदान किया गया है। URL पैरामीटर के माध्यम से इंजन स्विचिंग, मानचित्र प्रकार, 2D/3D डिस्प्ले मोड, और Google Maps संगत अक्षांश-देशांतर पथ प्रारूप का उपयोग करके कैमरा स्थिति का निर्धारण किया जा सकता है। इसका लाइसेंस Apache-2.0 है।