📄️ Base entities
This page covers the fundamental building blocks of the SDK: coordinates, paths, and geographic areas.
📄️ Positions
This page covers position data representation using GemPosition and GemImprovedPosition classes for GPS-based systems.
📄️ Landmarks
A landmark is a predefined, permanent location that holds detailed information such as its name, address, description, geographic area, categories (e.g., Gas Station, Shopping), entrance locations, contact details, and sometimes associated multimedia (e.g., icons or images). It represents significant, categorized locations with rich metadata, providing structured context about a place.
📄️ Markers
A marker is a visual element placed at a geographic location to indicate a point of interest. Markers can be icons, polylines, or polygons representing temporary or user-defined locations, waypoints, or annotations.
📄️ Overlays
An Overlay is an additional map layer with data stored on Magic Lane servers, accessible in online and offline modes. Overlays can be default or user-defined.
📄️ Landmarks vs Markers vs Overlays
When building a sophisticated mapping application, choosing the right type of object to use for your specific needs is crucial. To assist in making an informed decision, we compare the three core mapping entities in the table below:
📄️ Routes
A route represents a navigable path between two or more landmarks (waypoints), including distance, estimated time, and navigation instructions.
📄️ Navigation instructions
The Maps SDK for Flutter provides real-time navigation guidance with detailed route information, including road details, street names, speed limits, and turn directions. You receive essential data such as remaining travel time, distance to destination, and upcoming maneuvers.
📄️ Traffic Events
The Maps SDK for Flutter provides real-time information about traffic events such as delays, roadworks, and accidents.
📄️ Images
Images are represented in an abstract form that requires conversion before displaying on the UI. The SDK provides the following image classes: Img, AbstractGeometryImg, LaneImg, SignpostImg, and RoadInfoImg.