TomTom Maps SDK for JavaScript
This is the documentation of version 0.62.1. Go to the latest version, 1.0.0-rc.5.
TomTom Maps for JavaScript
    Preparing search index...

    Class RouteFlyover

    A camera that flies a route on a loop: it advances a distance along the line every frame, reads the coordinate the route has at that distance, and points itself at where it will be next.

    The route is the only geometry it needs — no path of camera keyframes to author, and no animation to re-time when the route changes. What it adds on top of following the line:

    • it aims ahead rather than at its own position, by distance, by route vertices or at the next guidance instruction, so the view turns into a bend before the camera reaches it;
    • it frames what is coming: the zoom that fits the next junctions, or one tied to the speed;
    • it clears the ground, pulling back where terrain would come between the camera and the road;
    • it parks the position where you want it on screen — see FlyoverAnchor — and marks it with an arrow, or an image of your own, facing the road;
    • it moves like a camera: every value it changes eases on a critically damped spring, so a new heading, zoom or setting bends the motion rather than kicking it, and a start ramps the speed.

    While it runs, the flight owns the altitude of the point the camera looks at — the ground under the followed position — so it takes MapLibre off clamping the centre to the ground, and gives that back when it stops.

    import { RouteFlyover } from '@tomtom-org/maps-sdk-plugin-flyover';

    const [route] = (await calculateRoute({ locations, guidance: { type: 'coded' } })).features;
    const flyover = new RouteFlyover(map, { route, camera: { speedKMH: 300, pitch: 76 } });
    flyover.start();
    Index
    constructor
    running
    getCamera remove seek setCamera setMarker setRoute start stop
    • get running(): boolean

      Whether the flight is advancing.

      Returns boolean

    • Stops the flight and gives the map back: the marker leaves, and the padding returns to what the map had before the flight first placed the camera.

      Returns void

    • Moves the flight to a point along the route, as a share of its length within 0..1.

      Parameters

      • fraction: number

      Returns void

    • Applies camera settings — speed, pitch, aim, framing, anchor — paused or under way.

      Parameters

      Returns void

    • Puts a new route under the flight, from its departure point.

      Parameters

      Returns void

    • Starts, or resumes, the flight, ramping up to its speed.

      Returns void

    • Stops the flight where it is; start resumes from there. The centre clamp goes back to what the map had before start.

      Returns void

    Settings
    Member Visibility

    On This Page
    Constructors
    Accessors
    Methods