[Feat] elevation field in MapViewState

[charlieforward9]

Target Use Case

Camera tracking on a trip layer with Tile3DLayer, with dynamic elevation

Screen.Recording.2024-12-01.at.11.04.32.PM.mov

Notice how the map is tracking the lat/lng, but given its vertical displacement and the set bearing, it does not correctly center the head of the trip. (I am toggling ReactGoogleMaps and Tile3DLayer to portray difference)

Proposal

Extend the MapViewState to include elevation.

export type MapViewState = {
  /** Longitude of the map center */
  longitude: number;
  /** Latitude of the map center */
  latitude: number;
+ /** Elevation of the map center, in meters */
+ elevation: number;
  /** Zoom level */
  zoom: number;
  /** Pitch (tilt) of the map, in degrees. `0` looks top down */
  pitch?: number;
  /** Bearing (rotation) of the map, in degrees. `0` is north up */
  bearing?: number;
  /** Min zoom, default `0` */
  minZoom?: number;
  /** Max zoom, default `20` */
  maxZoom?: number;
  /** Min pitch, default `0` */
  minPitch?: number;
  /** Max pitch, default `60` */
  maxPitch?: number;
  /** Viewport center offsets from lng, lat in meters */
  position?: number[];
} & CommonViewState;

[charlieforward9]

deckgl.3dtile.panning.issue.mov

See this interaction bug, which seems to be related, the map is panning relative to (x,y,0) instead of (x,y,z)

[chrisgervang]

Does position: [0, 0, elevation]; work for you?

[charlieforward9]

Yes! I did not realize that elevation could be included here. Thank you for specifying.