การตั้งค่า deck.gl
นี่คือขั้นตอนการใช้ deck.gl เป็นแผนที่ของ MapConductor บนเว็บ ไม่ต้องใช้คีย์ และสามารถใช้แรสเตอร์ไทล์ XYZ ใดก็ได้เป็นแผนที่ฐาน
ก่อนเริ่ม
ติดตั้ง
deck.gl (@deck.gl/core・layers・geo-layers 9.x) จะถูกติดตั้งมาพร้อมกันในฐานะ dependencies
npm install @mapconductor/js-sdk-core @mapconductor/js-sdk-react \
@mapconductor/react-for-deckglเลือกแผนที่ฐาน
deck.gl เองไม่มีแผนที่ในตัว ดังนั้นแผนที่ฐานจะวาดจากแรสเตอร์ไทล์ XYZ นอกจากดีไซน์ที่เตรียมให้แล้ว คุณยังส่งเทมเพลต URL ของไทล์เพื่อใช้ไทล์ของตัวเองได้ การแสดงที่มา (attribution) เขียนไว้ที่ 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;ไม่โหลดจนกว่าจะจำเป็น
การ import @mapconductor/react-for-deckgl ที่รูทจะโหลดตัว deck.gl เองมาด้วย หากต้องการเพียงสถานะและดีไซน์ สามารถดึงจาก @mapconductor/react-for-deckgl/state ได้ จึงโหลดตัวแผนที่เองในภายหลังด้วย lazy() ได้ DeckGLView เป็นคอมโพเนนต์ที่เพียง import DeckGLMapView จากรูทแล้วส่ง 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 และจะโยน exception หากมีเวอร์ชันอื่นอยู่แล้ว SDK ของ Longdo นำ deck.gl 8.x เข้ามาเอง และ Mappls ก็ทำเช่นเดียวกัน อย่าวางไว้ในหน้าเดียวกัน และให้โหลด deck.gl ผ่าน /state และ lazy() เมื่อจำเป็นเท่านั้น
การหมุนแผนที่จะหมุนชื่อสถานที่ไปด้วย
- เนื่องจากแผนที่ฐานเป็นแรสเตอร์ไทล์ ตัวอักษรจึงเป็นส่วนหนึ่งของภาพ หากต้องการให้ตัวอักษรตั้งตรงอยู่เสมอ โปรดเลือกใช้อย่างอื่นที่วาดสไตล์แบบเวกเตอร์ได้ เช่น MapLibre
ไม่สามารถหยุดเฉพาะการหมุนหรือเฉพาะการเอียงได้
- เนื่องจาก dragRotate ของ deck.gl จัดการทั้งสองอย่างรวมกัน จึงหยุดเพียงอย่างใดอย่างหนึ่งเดี่ยวไม่ได้ หากระบุเช่นนั้น ทั้งสองอย่างจะยังคงเปิดใช้งานอยู่และจะแสดงคำเตือนเพียงครั้งเดียว
ถัดไป
คุณสามารถวาดมาร์กเกอร์ วงกลม โพลีไลน์ โพลีกอน ภาพพื้นผิว และเลเยอร์แรสเตอร์ด้วยโค้ดแบบเดียวกับโปรไวเดอร์อื่นๆ หากต้องการซ้อนทับสไตล์เวกเตอร์ โปรดใช้เลเยอร์แผนที่เวกเตอร์ร่วมกับ DeckGLDesign.None