Skjölun / Uppsetning / React / deck.gl

Uppsetning á deck.gl

Þetta eru leiðbeiningar um að nota deck.gl sem kort fyrir MapConductor á vefnum. Enginn lykill er nauðsynlegur og fyrir grunnkortið má nota hvaða XYZ raster-flísar sem er.

PACKAGE
react-for-deckgl
API KEY
Ekki nauðsynlegt
CSS
Ekki nauðsynlegt
3D CAMERA
Halli og snúningur

Áður en þú byrjar

Node.js 18 eða nýrri
React 18 eða 19
STEP 01

Setja upp

deck.gl (@deck.gl/core, layers, geo-layers 9.x) fylgir með sem háð.

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

Velja grunnkort

deck.gl hefur sjálft ekkert kort, svo grunnkortinu er teiknað úr XYZ raster-flísum. Auk unninna útlita má gefa með flísa-URL-sniðmát og nota eigin flísar. Tilvísunargögn eru skilgreind í 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;
VARÚÐ
Opinberi flísaþjónninn hjá OpenStreetMap hefur notkunarmarkmið. Ef raunverulegur umferð í framleiðslu á að fara um þjónustuna skal nota eigin flísa dreifingu eða kaupaþjónustu.
STEP 03

Ekki hlaða inn fyrr en þörf er á

Ef þú importar @mapconductor/react-for-deckgl frá rótinni er deck.gl sjálft hlaðið inn. Ef þú þarft aðeins ástand og hönnun geturðu sótt það frá @mapconductor/react-for-deckgl/state, svo kortið sjálft er hægt að hlaða inn seinna með lazy(). DeckGLView er einfaldur þáttur sem importar DeckGLMapView frá rótinni og færir honum 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>
  );
}

STAÐFESTA

Það sem þú ættir að sjá

Þegar kortið og merkin birtast er lokið.

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

Kortahönnun

DeckGLDesign er gildi sem pakkar inn flísa-URL-sniðmáti. Ef eigin flísar eru notaðar er búið til nýtt instance af sama tagi með new.

DeckGLDesign
Notes
Standard
Stöðluð flís OpenStreetMap. Hámarks zoom 19
Satellite
Loftmyndir úr Esri World Imagery
Dark
Dökkt kort frá CARTO. Hámarks zoom 20
Light
Ljóst kort frá CARTO. Hámarks zoom 20
None
Engar grunnflísar. Þegar aðeins á að teikna overlay eða vector-útlit

Bilanaleit

Villur koma ef sett á sömu síðu og Longdo eða Mappls

  • deck.gl skráir sína útgáfu í globalThis.deck og kastar undantekningu ef önnur útgáfa er þegar til. SDK frá Longdo flytur með sér deck.gl 8.x og Mappls gerir hið sama. Ekki setja þau á sömu síðu, heldur skal nota /state og lazy() svo deck.gl sé ekki hlaðið inn fyrr en þörf krefur.

Staðnöfn snúast með kortinu

  • Grunnkortið er úr raster-flísum, svo texti er hluti myndarinnar. Ef texti á að stay uppréttur þarf að velja eitthvað sem getur teiknað vector-útlit, svo sem MapLibre.

Ekki er hægt að stöðva aðeins snúning eða aðeins halla

  • dragRotate í deck.gl sér um bæði samtímis, svo ekki er hægt að stöðva aðeins annað tveggja. Ef það er tiltekið eru bæði áfram virk og aðeins ein viðvörun birtist.

Næst

Merki, hringir, marglínur, marghyrningur, yfirborðsmýndir og raster-lög eru teiknuð með sama kóða og hjá öðrum veitum. Ef þú vilt lagna vigursnið, samsett du vigurflísarlag með DeckGLDesign.None.