deck.gl का सेटअप
Web पर deck.gl को MapConductor के नक्शे के रूप में उपयोग करने के चरण। कुंजी की आवश्यकता नहीं है, और बेसमैप के लिए कोई भी XYZ रैस्टर टाइल उपयोग की जा सकती है।
शुरू करने से पहले
इंस्टॉल करें
deck.gl (@deck.gl/core・layers・geo-layers 9.x) निर्भरता के रूप में साथ इंस्टॉल हो जाता है।
npm install @mapconductor/js-sdk-core @mapconductor/js-sdk-react \
@mapconductor/react-for-deckglबेसमैप तय करें
deck.gl स्वयं का नक्शा नहीं रखता, इसलिए बेसमैप XYZ रैस्टर टाइल से बनाया जाता है। उपलब्ध डिज़ाइनों के अलावा, टाइल URL टेम्पलेट पास करके अपनी टाइल भी उपयोग कर सकते हैं। एट्रिब्यूशन प्रदर्शन attributionRules में लिखा जाता है।
import { DeckGLDesign } from '@mapconductor/react-for-deckgl';
const gsi = new DeckGLDesign({
id: 'gsi-standard',
tileUrl: 'https://cyberjapandata.gsi.go.jp/xyz/std/{z}/{x}/{y}.png',
tileSize: 256,
maxZoom: 18,
attributionRules: [{ attribution: '国土地理院' }],
});
state.mapDesignType = gsi;ज़रूरत तक लोड न करें
रूट से @mapconductor/react-for-deckgl को import करने पर deck.gl की मुख्य बॉडी लोड हो जाती है। अगर केवल state और डिज़ाइन चाहिए, तो वे @mapconductor/react-for-deckgl/state से लिए जा सकते हैं, इसलिए मैप को खुद lazy() से बाद में लोड किया जा सकता है। DeckGLView एक ऐसा कॉम्पोनेंट है जो केवल रूट से DeckGLMapView को import करके उसे state पास करता है।
import { lazy, Suspense } from 'react';
import { DeckGLDesign, useDeckGLMapViewState } from '@mapconductor/react-for-deckgl/state';
const DeckGLView = lazy(() => import('./DeckGLView'));
export function Page() {
const state = useDeckGLMapViewState({ mapDesignType: DeckGLDesign.Dark });
return (
<Suspense fallback={null}>
<DeckGLView state={state} />
</Suspense>
);
}जाँच
आपको क्या दिखना चाहिए
नक्शा और मार्कर दिख जाएं तो पूर्ण।
import { createGeoPoint, createMapCameraPosition, createMarkerState } from '@mapconductor/js-sdk-core';
import { Marker } from '@mapconductor/js-sdk-react';
import { DeckGLDesign, DeckGLMapView, useDeckGLMapViewState } from '@mapconductor/react-for-deckgl';
import { useState } from 'react';
const TOKYO = createGeoPoint({ latitude: 35.6812, longitude: 139.7671 });
export function DeckGLMap() {
const state = useDeckGLMapViewState({
mapDesignType: DeckGLDesign.Standard,
cameraPosition: createMapCameraPosition({ position: TOKYO, zoom: 12 }),
});
const [markerState] = useState(() => createMarkerState({ id: 'tokyo', position: TOKYO }));
return (
<DeckGLMapView state={state} containerStyle={{ height: 480 }}>
<Marker state={markerState} />
</DeckGLMapView>
);
}मैप डिज़ाइन
DeckGLDesign टाइल URL टेम्पलेट को लपेटने वाला मान है। अपनी टाइल उपयोग करने पर उसी प्रकार को new करें।
समस्या निवारण
Longdo या Mappls के साथ उसी पेज पर रखने पर त्रुटि होती है
- deck.gl अपने संस्करण को globalThis.deck में रजिस्टर करता है और यदि कोई अन्य संस्करण पहले से मौजूद है तो अपवाद फेंकता है। Longdo का SDK deck.gl 8.x लाता है, और Mappls भी वही करता है। उन्हें उसी पेज पर न रखें; /state और lazy() से deck.gl को ज़रूरत तक लोड न करें।
नक्शा घुमाने पर स्थान के नाम भी घूमते हैं
- बेसमैप रैस्टर टाइल है, इसलिए टेक्स्ट भी छवि का हिस्सा है। यदि आप टेक्स्ट को सीधा रखना चाहते हैं, तो MapLibre जैसा विकल्प चुनें जो वेक्टर स्टाइल बना सके।
केवल घुमाव या केवल झुकाव रोका नहीं जा सकता
- deck.gl का dragRotate दोनों को एक साथ संभालता है, इसलिए केवल एक को रोकना संभव नहीं है। यह निर्दिष्ट करने पर दोनों सक्रिय रहते हैं और एक बार चेतावनी दिखती है।
आगे
मार्कर, सर्कल, पॉलीलाइन, पॉलीगॉन, ग्राउंड इमेज और रैस्टर लेयर को अन्य प्रोवाइडर्स के समान कोड से ड्रा किया जा सकता है। वेक्टर स्टाइल को ओवरले करना हो तो, वेक्टर टाइल लेयर को DeckGLDesign.None के साथ संयोजित करें।