Creates the plugin bound to a TomTom map and starts rendering landmarks as soon as the map is ready.
The TomTom map instance to render landmarks on.
Optionaloptions: Landmarks3DOptions
The knobs to start with, how to request tiles, and where to load the texture transcoder from.
The user events of the landmarks: a handler gets the landmark under the pointer, with its id and
its position as [longitude, latitude].
hover.color and the clicked one
towards click.color, until the next click lands elsewhere.The underlying MapLibre custom layer, for advanced use beyond this facade.
Replaces the whole configuration. An empty object unsets every knob, back to the base map's 3D buildings or the knob's own default.
Use it, and updateConfig, for a look your code writes: as on a map module, the type is
the check, and the values are not checked again. For values held as data, the SDK's setKnobs
checks each against landmarks3DKnobCatalogue and sets them by id.
Returns the knobs set, as a plain serializable copy. The SDK's getKnob reads a knob's value
in force: when unset, the base map's, or the knob's own default.
The colours setLandmarkColors gave, by id.
Whether the landmarks are set to be shown: the visible knob, true unless set.
Unsets every knob, so the landmarks are shown and look like the base map's 3D buildings, with each other knob at its own default.
Gives the landmarks with these ids a colour of their own, in place of their color and palette
colour, and every other one its own colour back. An empty object clears them.
The ids are the ones events report, which stay the same in every session, so you can
colour a landmark before it loads. Under texture: 'color', a landmark you colour draws as under
detail: your colour, with its texture's light and shade over it.
Shows or hides the landmarks. Stored as visible in the configuration.
true to show landmarks, false to hide them.
Changes the given knobs and keeps the others, one level deep: a part you pass, such as hover,
replaces that part's values.
Renders TomTom Orbis 3D Landmarks (high-detail building meshes) on a TomTomMap.
The plugin streams GLB tiles from the Orbis 3D Landmarks API (Private Preview), renders them with Three.js via a MapLibre custom layer, filters overlapping extruded basemap buildings out of the style, and keeps everything restored across map style changes.
Remarks
Private Preview until the plugin's 1.0.0 release.
It requires an API key with Orbis 3D Landmarks entitlements. Its look is a set of knobs, listed in landmarks3DKnobCatalogue.
streetLightstyle's look.buildings3Dgroup of theBaseMapModule, hidden in most standard styles; the plugin leaves it as it is.Example