เอกสาร / การตั้งค่า / React / deck.gl

การตั้งค่า deck.gl

นี่คือขั้นตอนการใช้ 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) จะถูกติดตั้งมาพร้อมกันในฐานะ dependencies

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

เลือกแผนที่ฐาน

deck.gl เองไม่มีแผนที่ในตัว ดังนั้นแผนที่ฐานจะวาดจากแรสเตอร์ไทล์ XYZ นอกจากดีไซน์ที่เตรียมให้แล้ว คุณยังส่งเทมเพลต URL ของไทล์เพื่อใช้ไทล์ของตัวเองได้ การแสดงที่มา (attribution) เขียนไว้ที่ 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 มีนโยบายการใช้งาน หากจะส่งทราฟฟิกจริงในระบบ production โปรดใช้การแจกจ่ายไทล์ของตัวเองหรือบริการเชิงพาณิชย์
STEP 03

ไม่โหลดจนกว่าจะจำเป็น

การ import @mapconductor/react-for-deckgl ที่รูทจะโหลดตัว deck.gl เองมาด้วย หากต้องการเพียงสถานะและดีไซน์ สามารถดึงจาก @mapconductor/react-for-deckgl/state ได้ จึงโหลดตัวแผนที่เองในภายหลังด้วย lazy() ได้ DeckGLView เป็นคอมโพเนนต์ที่เพียง import DeckGLMapView จากรูทแล้วส่ง 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
ไม่มีไทล์ฐาน ใช้เมื่อต้องการวาดเฉพาะ overlay หรือสไตล์แบบเวกเตอร์

การแก้ปัญหา

เกิดข้อผิดพลาดเมื่อวางไว้ในหน้าเดียวกับ Longdo หรือ Mappls

  • deck.gl จะลงทะเบียนเวอร์ชันของตัวเองไว้ที่ globalThis.deck และจะโยน exception หากมีเวอร์ชันอื่นอยู่แล้ว SDK ของ Longdo นำ deck.gl 8.x เข้ามาเอง และ Mappls ก็ทำเช่นเดียวกัน อย่าวางไว้ในหน้าเดียวกัน และให้โหลด deck.gl ผ่าน /state และ lazy() เมื่อจำเป็นเท่านั้น

การหมุนแผนที่จะหมุนชื่อสถานที่ไปด้วย

  • เนื่องจากแผนที่ฐานเป็นแรสเตอร์ไทล์ ตัวอักษรจึงเป็นส่วนหนึ่งของภาพ หากต้องการให้ตัวอักษรตั้งตรงอยู่เสมอ โปรดเลือกใช้อย่างอื่นที่วาดสไตล์แบบเวกเตอร์ได้ เช่น MapLibre

ไม่สามารถหยุดเฉพาะการหมุนหรือเฉพาะการเอียงได้

  • เนื่องจาก dragRotate ของ deck.gl จัดการทั้งสองอย่างรวมกัน จึงหยุดเพียงอย่างใดอย่างหนึ่งเดี่ยวไม่ได้ หากระบุเช่นนั้น ทั้งสองอย่างจะยังคงเปิดใช้งานอยู่และจะแสดงคำเตือนเพียงครั้งเดียว

ถัดไป

คุณสามารถวาดมาร์กเกอร์ วงกลม โพลีไลน์ โพลีกอน ภาพพื้นผิว และเลเยอร์แรสเตอร์ด้วยโค้ดแบบเดียวกับโปรไวเดอร์อื่นๆ หากต้องการซ้อนทับสไตล์เวกเตอร์ โปรดใช้เลเยอร์แผนที่เวกเตอร์ร่วมกับ DeckGLDesign.None