Configurar deck.gl
Estos son los pasos para usar deck.gl como mapa de MapConductor en la Web. No requiere clave y el mapa base puede usar cualquier tesela ráster XYZ.
Antes de empezar
Instalar
deck.gl (@deck.gl/core, layers, geo-layers 9.x) se incluye junto como dependencia.
npm install @mapconductor/js-sdk-core @mapconductor/js-sdk-react \
@mapconductor/react-for-deckglElegir el mapa base
Como deck.gl en sí no incluye mapa, el mapa base se dibuja a partir de teselas ráster XYZ. Además de los diseños incluidos, si pasa una plantilla de URL de teselas también puede usar sus propias teselas. La atribución se escribe en 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;No cargar hasta que sea necesario
Al importar @mapconductor/react-for-deckgl desde la raíz se carga el propio deck.gl. Si solo necesitas el estado y el diseño, puedes obtenerlos desde @mapconductor/react-for-deckgl/state, de modo que el mapa en sí puede cargarse más tarde con lazy(). DeckGLView es un componente que simplemente importa DeckGLMapView desde la raíz y le pasa el estado.
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>
);
}VERIFICAR
Lo que deberías ver
Ya está cuando aparezcan el mapa y los marcadores.
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>
);
}Diseños de mapa
DeckGLDesign es un valor que envuelve la plantilla de URL de teselas. Si usa sus propias teselas, cree una instancia del mismo tipo con new.
Solución de problemas
Da error si se coloca en la misma página que Longdo o Mappls
- deck.gl registra su versión en globalThis.deck y lanza una excepción si ya existe otra versión. El SDK de Longdo incluye deck.gl 8.x y Mappls hace lo mismo. No los coloque en la misma página, y no cargue deck.gl hasta que sea necesario usando /state y lazy().
Al rotar el mapa también rotan los nombres de lugares
- Como el mapa base son teselas ráster, los textos también son parte de la imagen. Si quiere mantener los textos verticales, elija algo como MapLibre, que puede dibujar estilos vectoriales.
No se puede detener solo la rotación o solo la inclinación
- Como el dragRotate de deck.gl maneja ambos a la vez, no se puede detener solo uno. Si se especifica así, ambos quedan activos y se muestra una sola advertencia.
Siguiente
Los marcadores, círculos, polilíneas, polígonos, imágenes de superficie y capas ráster se pueden dibujar con el mismo código que con otros proveedores. Cuando desee superponer estilos vectoriales, combine la capa de teselas vectoriales con DeckGLDesign.None.