दस्तावेज़ / सेटअप / React / deck.gl

deck.gl का सेटअप

Web पर deck.gl को MapConductor के नक्शे के रूप में उपयोग करने के चरण। कुंजी की आवश्यकता नहीं है, और बेसमैप के लिए कोई भी XYZ रैस्टर टाइल उपयोग की जा सकती है।

PACKAGE
react-for-deckgl
API KEY
आवश्यक नहीं
CSS
आवश्यक नहीं
3D CAMERA
झुकाव और घुमाव

शुरू करने से पहले

Node.js 18 या उससे अधिक
React 18 या 19
STEP 01

इंस्टॉल करें

deck.gl (@deck.gl/core・layers・geo-layers 9.x) निर्भरता के रूप में साथ इंस्टॉल हो जाता है।

terminalnpm
npm install @mapconductor/js-sdk-core @mapconductor/js-sdk-react \
            @mapconductor/react-for-deckgl
STEP 02

बेसमैप तय करें

deck.gl स्वयं का नक्शा नहीं रखता, इसलिए बेसमैप XYZ रैस्टर टाइल से बनाया जाता है। उपलब्ध डिज़ाइनों के अलावा, टाइल URL टेम्पलेट पास करके अपनी टाइल भी उपयोग कर सकते हैं। एट्रिब्यूशन प्रदर्शन attributionRules में लिखा जाता है।

designs.tsTypeScript
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;
सावधानी
OpenStreetMap के सार्वजनिक टाइल सर्वर की एक उपयोग नीति है। प्रोडक्शन ट्रैफ़िक भेजने की स्थिति में, कृपया अपना टाइल वितरण या कोई वाणिज्यिक सेवा उपयोग करें।
STEP 03

ज़रूरत तक लोड न करें

रूट से @mapconductor/react-for-deckgl को import करने पर deck.gl की मुख्य बॉडी लोड हो जाती है। अगर केवल state और डिज़ाइन चाहिए, तो वे @mapconductor/react-for-deckgl/state से लिए जा सकते हैं, इसलिए मैप को खुद lazy() से बाद में लोड किया जा सकता है। DeckGLView एक ऐसा कॉम्पोनेंट है जो केवल रूट से DeckGLMapView को import करके उसे state पास करता है।

Page.tsxTypeScript · React
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>
  );
}

जाँच

आपको क्या दिखना चाहिए

नक्शा और मार्कर दिख जाएं तो पूर्ण।

DeckGLMap.tsxTypeScript · React
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 करें।

DeckGLDesign
Notes
Standard
OpenStreetMap की मानक टाइल। अधिकतम ज़ूम 19
Satellite
Esri World Imagery की हवाई तस्वीरें
Dark
CARTO का गहरा नक्शा। अधिकतम ज़ूम 20
Light
CARTO का हल्का नक्शा। अधिकतम ज़ूम 20
None
बेस टाइल नहीं। जब आप केवल ओवरले या वेक्टर स्टाइल बनाना चाहते हों

समस्या निवारण

Longdo या Mappls के साथ उसी पेज पर रखने पर त्रुटि होती है

  • deck.gl अपने संस्करण को globalThis.deck में रजिस्टर करता है और यदि कोई अन्य संस्करण पहले से मौजूद है तो अपवाद फेंकता है। Longdo का SDK deck.gl 8.x लाता है, और Mappls भी वही करता है। उन्हें उसी पेज पर न रखें; /state और lazy() से deck.gl को ज़रूरत तक लोड न करें।

नक्शा घुमाने पर स्थान के नाम भी घूमते हैं

  • बेसमैप रैस्टर टाइल है, इसलिए टेक्स्ट भी छवि का हिस्सा है। यदि आप टेक्स्ट को सीधा रखना चाहते हैं, तो MapLibre जैसा विकल्प चुनें जो वेक्टर स्टाइल बना सके।

केवल घुमाव या केवल झुकाव रोका नहीं जा सकता

  • deck.gl का dragRotate दोनों को एक साथ संभालता है, इसलिए केवल एक को रोकना संभव नहीं है। यह निर्दिष्ट करने पर दोनों सक्रिय रहते हैं और एक बार चेतावनी दिखती है।

आगे

मार्कर, सर्कल, पॉलीलाइन, पॉलीगॉन, ग्राउंड इमेज और रैस्टर लेयर को अन्य प्रोवाइडर्स के समान कोड से ड्रा किया जा सकता है। वेक्टर स्टाइल को ओवरले करना हो तो, वेक्टर टाइल लेयर को DeckGLDesign.None के साथ संयोजित करें।