दस्तावेज़ / सेटअप / React / Longdo
Longdo का सेटअप
Web पर Longdo Map को MapConductor से उपयोग करने की प्रक्रिया है। यह थाई नक्शे में मजबूत प्रदाता है, और यह Longdo Map JS API3 को रैप करता है।
PACKAGE
react-for-longdo
API KEY
आवश्यक
CSS
अनावश्यक
REACT NATIVE
कोई नहीं
शुरू करने से पहले
Node.js 18 या उच्चतर
Longdo Map कंसोल से जारी की गई API कुंजी
STEP 01
इंस्टॉल करें
Longdo Map JS API3 पैकेज को कुंजी के साथ गतिशील रूप से लोड करता है। script टैग लिखने की आवश्यकता नहीं है।
terminalnpm
npm install @mapconductor/js-sdk-core @mapconductor/js-sdk-react \
@mapconductor/react-for-longdoSTEP 02
API कुंजी को स्टेट हुक में पास करें
कुंजी को डोमेन से बांधकर पंजीकृत किया जाता है। यदि खाली स्ट्रिंग रहेगी तो नक्शा लोड नहीं होगा।
LongdoMap.tsxTypeScript · React
const state = useLongdoViewState({
apiKey: import.meta.env.VITE_LONGDO,
mapDesignType: LongdoDesign.Normal,
cameraPosition: createMapCameraPosition({ position: BANGKOK, zoom: 12 }),
});सावधानी
कुंजी को बिल्ड समय के वातावरण चर (Vite हो तो import.meta.env.VITE_*) से पास करें, और इसे स्रोत प्रबंधन में न रखें। जब तक यह फ्रंटएंड तक पहुंचती है, इसे लीक होने पर कोई नुकसान न हो, इसलिए रेफरर प्रतिबंध और डोमेन प्रतिबंध जरूर लगाएं।
जाँच
आपको क्या दिखना चाहिए
बैंकॉक को केंद्र में रखकर नक्शा दिखे तो काम पूरा है।
LongdoMap.tsxTypeScript · React
import { useState } from 'react';
import { createGeoPoint, createMapCameraPosition, createMarkerState } from '@mapconductor/js-sdk-core';
import { Marker } from '@mapconductor/js-sdk-react';
import { LongdoDesign, LongdoMapView2D, useLongdoViewState } from '@mapconductor/react-for-longdo';
const BANGKOK = createGeoPoint({ latitude: 13.7563, longitude: 100.5018 });
export function LongdoMap() {
const state = useLongdoViewState({
apiKey: import.meta.env.VITE_LONGDO,
mapDesignType: LongdoDesign.Normal,
cameraPosition: createMapCameraPosition({ position: BANGKOK, zoom: 12 }),
});
const [markerState] = useState(() => createMarkerState({ id: 'bkk', position: BANGKOK }));
return (
<LongdoMapView2D state={state} style={{ height: 480 }}>
<Marker state={markerState} />
</LongdoMapView2D>
);
}मैप डिज़ाइन
LongdoDesign, Longdo के बेस लेयर के साथ संगत है।
LongdoDesign
Notes
Normal / Easy / Political
मानक शैलियाँ
Pastel / PastelGray / Light / Gray
हल्की शैलियाँ
Night / Dark / Hard
गहरा/उच्च कंट्रास्ट
Satellite / Hybrid
उपग्रह छवि और हाइब्रिड
Osm
OpenStreetMap आधारित
समस्या निवारण
नक्शा नहीं दिख रहा
- apiKey खाली स्ट्रिंग नहीं है इसकी पुष्टि करें।
- कंसोल में कुंजी डिलीवरी डोमेन से बंधी है इसकी पुष्टि करें।
केवल विकास के दौरान नक्शा दोहरा रूप से इनिशियलाइज़ होता है
- React StrictMode effect को दो बार निष्पादित करता है। प्रत्येक प्रदाता इसे पहचानकर एक को त्याग देता है, इसलिए StrictMode को हटाने की आवश्यकता नहीं है।
आगे
LongdoMapView 3D है, LongdoMapView2D 2D है। दोनों एक ही स्टेट ऑब्जेक्ट साझा करते हैं।