Doku / Einrichtung / React / deck.gl

deck.gl einrichten

Dies ist die Anleitung, um deck.gl als Karte von MapConductor im Web zu verwenden. Ein Schlüssel ist nicht erforderlich; als Basiskarte können beliebige XYZ-Rasterkacheln verwendet werden.

PACKAGE
react-for-deckgl
API KEY
Nicht erforderlich
CSS
Nicht erforderlich
3D CAMERA
Neigung · Rotation

Bevor Sie beginnen

Node.js 18 oder höher
React 18 oder 19
STEP 01

Installation

deck.gl (@deck.gl/core, layers, geo-layers 9.x) wird als Abhängigkeit mitgeliefert.

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

Basiskarte festlegen

Da deck.gl selbst keine Karte mitbringt, wird die Basiskarte aus XYZ-Rasterkacheln gezeichnet. Neben den bereitgestellten Designs können eigene Kacheln verwendet werden, indem eine Kachel-URL-Vorlage übergeben wird. Die Attribution wird in attributionRules definiert.

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;
ACHTUNG
Der öffentliche Kachelserver von OpenStreetMap hat eine Nutzungspolicy. Für Produktionsverkehr verwenden Sie bitte eine eigene Kachelauslieferung oder einen kommerziellen Dienst.
STEP 03

Laden erst bei Bedarf

Das Importieren des Root-@mapconductor/react-for-deckgl lädt deck.gl selbst. Wenn Sie nur den Zustand und das Design benötigen, können Sie diese aus @mapconductor/react-for-deckgl/state beziehen, sodass die Karte selbst später über lazy() geladen werden kann. DeckGLView ist eine Komponente, die lediglich DeckGLMapView aus dem Root importiert und den state übergibt.

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>
  );
}

PRÜFEN

Was Sie sehen sollten

Wenn Karte und Marker erscheinen, ist alles fertig.

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>
  );
}

Kartendesigns

DeckGLDesign ist ein Wert, der eine Kachel-URL-Vorlage kapselt. Wenn Sie eigene Kacheln verwenden, erzeugen Sie denselben Typ mit new.

DeckGLDesign
Notes
Standard
Standardkacheln von OpenStreetMap. Maximaler Zoom 19
Satellite
Luftbilder von Esri World Imagery
Dark
Dunkle Karte von CARTO. Maximaler Zoom 20
Light
Helle Karte von CARTO. Maximaler Zoom 20
None
Keine Basiskacheln. Wenn nur Overlays oder Vektor-Styles gezeichnet werden sollen

Fehlerbehebung

Fehler bei Platzierung auf derselben Seite wie Longdo oder Mappls

  • deck.gl registriert seine Version in globalThis.deck und wirft eine Ausnahme, wenn bereits eine andere Version vorhanden ist. Das SDK von Longdo bringt deck.gl 8.x mit, und Mappls tut dasselbe. Platzieren Sie es nicht auf derselben Seite, und laden Sie deck.gl erst bei Bedarf über /state und lazy().

Beim Drehen der Karte drehen sich auch die Ortsnamen

  • Da die Basiskarte aus Rasterkacheln besteht, sind auch Beschriftungen Teil des Bildes. Wenn Beschriftungen aufrecht bleiben sollen, wählen Sie stattdessen MapLibre oder Ähnliches, die Vektor-Styles zeichnen können.

Nur Rotation oder nur Neigung kann nicht gestoppt werden

  • Da dragRotate von deck.gl beides zusammen behandelt, kann nicht nur eines davon gestoppt werden. Bei dieser Angabe bleiben beide aktiviert, und es wird einmalig eine Warnung ausgegeben.

Weiter

Marker, Kreise, Polylines, Polygone, Bodenbilder und Rasterlayer lassen sich mit demselben Code wie bei anderen Anbietern zeichnen. Wenn Sie Vektorstile überlagern möchten, kombinieren Sie die Vektorkachelebene mit DeckGLDesign.None.