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.
Bevor Sie beginnen
Installation
deck.gl (@deck.gl/core, layers, geo-layers 9.x) wird als Abhängigkeit mitgeliefert.
npm install @mapconductor/js-sdk-core @mapconductor/js-sdk-react \
@mapconductor/react-for-deckglBasiskarte 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.
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;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.
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.
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.
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.