# Magic Lane - Maps SDK for C++ documentation


## Docs

- [Fleet Management](/docs/cpp/examples/fleet-management.md): Example applications for the Fleet Management C++ API are available on IssueTracker. You can clone the repository and launch the applications by following the setup instructions provided in the README file.
- [Add Optimization with Full Details](/docs/cpp/examples/fleet-management/add-full-optimization.md): The example covers the following features:
- [Add Optimization with Fixed Orders Sequence](/docs/cpp/examples/fleet-management/add-optim-with-fixed-sequence.md): This example demonstrates how to create an optimization where specific orders must be visited in a fixed sequence by the same vehicle. The example covers the following features:
- [Add Optimization with Multiple Departures](/docs/cpp/examples/fleet-management/add-optim-with-multiple-departures.md): The example covers the following features:
- [Add Optimization with Multiple Destinations](/docs/cpp/examples/fleet-management/add-optim-with-multiple-destinations.md): Overview
- [Add Optimization with Orders in the Same Route](/docs/cpp/examples/fleet-management/add-optim-with-orders-in-the-same-route.md): This example demonstrates how to create an optimization where specific orders must be visited by the same vehicle, ensuring they are part of the same route. The example covers the following features:
- [Add Optimization with Orders Sequences](/docs/cpp/examples/fleet-management/add-optim-with-orders-sequence.md): The example covers the following features:
- [Add Optimization with Orders Sequence Pairs](/docs/cpp/examples/fleet-management/add-optim-with-orders-sequence-pairs.md): The example covers the following features:
- [Add Optimization with Set Matrices](/docs/cpp/examples/fleet-management/add-optim-with-set-matrices.md): The example covers the following features:
- [Add Optimization with Single Vehicle](/docs/cpp/examples/fleet-management/add-optim-with-single-vehicle.md): The example covers the following features:
- [Add Orders to a Route](/docs/cpp/examples/fleet-management/add-orders-to-a-route.md): This example demonstrates how to add a list of orders into an existing route's order list at optimal positions determined by the algorithm. The orders will be inserted between existing route orders without rearranging them. If the route is reoptimized, the orders will be rearranged in the best order of visit, and you may not see them inserted at the original optimal positions.
- [Add Orders to an Optimization](/docs/cpp/examples/fleet-management/add-orders-to-an-optim.md): This example demonstrates how to add a list of orders to an existing optimization. The newly added orders will be assigned to the optimization’s routes if the optimization is reoptimized. If reoptimization is not enabled, the added orders will be stored but not assigned to routes.
- [Generate Territories](/docs/cpp/examples/fleet-management/generate-territories.md): This example demonstrates how to generate polygon territories from a list of coordinates and display them on a map. The example covers the following features:
- [Merge Routes](/docs/cpp/examples/fleet-management/merge-routes.md): This example demonstrates how to merge multiple routes into a single route. A new optimization will be created for the merged route, inheriting the configuration parameters, vehicle constraints, and other settings from the first route in the list. The merged route will not be optimized automatically.
- [Reoptimize Optimization](/docs/cpp/examples/fleet-management/reoptimize-optim.md): This example demonstrates how to reoptimize an existing optimization to generate a new and potentially better solution. The reoptimization process uses the latest fuel prices to calculate the new solution (refer to the Get Fuel Prices example).
- [Reoptimize Route](/docs/cpp/examples/fleet-management/reoptimize-route.md): This example demonstrates how to reoptimize an existing route to rearrange the orders in a better sequence of visits, if such a sequence exists. The reoptimization process uses the latest fuel prices to calculate the route's cost. For more details on retrieving fuel prices, refer to the Get Fuel Prices.
- [Unlink Route from Optimization](/docs/cpp/examples/fleet-management/unlink-route.md): This example demonstrates how to unlink a route from its optimization. When a route is unlinked, it will no longer be part of the optimization's solution. The orders visited in this route will be removed from the optimization, and a new optimization will be created for the unlinked route. The new optimization will retain the same configuration parameters, vehicle constraints, and other fields as the unlinked route.
- [Update Optimization](/docs/cpp/examples/fleet-management/update-optim.md): This example demonstrates how to update an existing optimization by making changes to its configuration, vehicles, constraints, and other fields. The updated optimization can also be reoptimized to generate a new solution. If the optimization is not reoptimized, the changes will not be applied to the optimization's routes.
- [Update Route](/docs/cpp/examples/fleet-management/update-route.md): This example demonstrates how to update an existing route by making changes to its configuration, vehicle constraints, and other fields. The updated route can also be reoptimized to generate a new order of visits. If the route is not reoptimized, the changes will not affect the route's optimization. However, certain configuration changes (e.g., ignoring time windows, optimization criteria, etc.) automatically trigger reoptimization.
- [Maps & 3D Scene](/docs/cpp/examples/maps-3dscene.md): Example applications for the Maps SDK for C++ are available on IssueTracker. You can clone the repository and launch the applications by following the setup instructions provided in the README file.
- [Center Map](/docs/cpp/examples/maps-3dscene/center-map.md): Center the map view over a pair of coordinates.
- [Change Map Style](/docs/cpp/examples/maps-3dscene/change-map-style.md): In this guide you will learn how to change the map style used to render an interactive map.
- [Map Perspective](/docs/cpp/examples/maps-3dscene/map-perspective.md): Toggle the map perspective or tilt/view angle.
- [Map Style](/docs/cpp/examples/maps-3dscene/map-style.md): Change the map style used to render the interactive map.
- [Map View](/docs/cpp/examples/maps-3dscene/map-view.md): Render an interactive map supporting pan and zoom.
- [Markers](/docs/cpp/examples/maps-3dscene/markers.md): In this guide you will learn how to draw point, polyline and polygon markers on an interactive map, as well as how to remove them.
- [Multi Map View](/docs/cpp/examples/maps-3dscene/multi-map-view.md): Show multiple map views.
- [Points Marker](/docs/cpp/examples/maps-3dscene/points-marker.md): Render a set of point markers on the interactive map.
- [Polygon Marker](/docs/cpp/examples/maps-3dscene/polygon-marker.md): Render a set of polygons on the interactive map.
- [Polyline Marker](/docs/cpp/examples/maps-3dscene/polyline-marker.md): Render a set of lines on the interactive map.
- [Public Transit Stop](/docs/cpp/examples/maps-3dscene/public-transit-stop.md): Retrieve the schedule information from a public transit stop overlay item.
- [Switch Map Perspective](/docs/cpp/examples/maps-3dscene/switch-map-perspective.md): In this guide you will learn how to toggle the interactive map view angle between vertical look-down, and perspective mode, with a view partially inclined toward the horizon.
- [Places & Search](/docs/cpp/examples/places-search.md): This collection of articles showcases a comprehensive suite of precision-driven location and search techniques - instantly delivering accurate POI results for landmarks, restaurants, businesses, cities, neighborhoods, attractions, and specific addresses; enabling the discovery of nearby, departure-point, or destination-relevant places (for example, EV charging stations) with essential details such as pricing, hours of operation, and landmark information; and providing global data online or offline, all seamlessly embedded directly in the map for up-to-the-minute, reliable navigation every time.
- [Free Text Search](/docs/cpp/examples/places-search/free-text-search.md): Search for places using text.
- [Location Wikipedia](/docs/cpp/examples/places-search/location-wikipedia.md): Retrieve wikipedia information from a landmark.
- [Multi Search](/docs/cpp/examples/places-search/multi-search.md): In this guide you will learn how search for POIs (points of interest) around a position, search free text around a position, and search within a specified rectangular area.
- [Search Around](/docs/cpp/examples/places-search/search-around.md): Search for nearby places, or reverse geocode, using a pair of coordinates.
- [Text Search in Geographic Area](/docs/cpp/examples/places-search/text-search-geographic-area.md): Search for places using free-form text. Obtain the results located within the given geographic area.
- [Routing & Navigation](/docs/cpp/examples/routing-navigation.md): The Maps SDK for C++ offers ready-to-run examples showcasing mode-aware routing - from battery-optimized EV charge paths and real-time traffic-aware car routes to bike-friendly lanes, truck-compliant roads, live transit connections, and pedestrian shortcuts - so you can quickly integrate tailored, high-performance navigation into your C++ applications.
- [Areas Alarms](/docs/cpp/examples/routing-navigation/areas-alarms.md): Receive real-time notifications for boundary crossings (entry/exit) within a designated area.
- [Calculate Route](/docs/cpp/examples/routing-navigation/calculate-route.md): In this guide you will learn how to calculate a route and render it on an interactive map.
- [Calculate Route Multi View](/docs/cpp/examples/routing-navigation/calculate-route-multi-view.md): Calculate 4 routes and add them in 4 separate interactive map views.
- [Export Track](/docs/cpp/examples/routing-navigation/export-track.md): This guide demonstrates the following features:
- [Feed Sensor Data](/docs/cpp/examples/routing-navigation/feed-sensor-data.md): Feed sensor data, such as position, acceleration, compass or temperature to the SDK.
- [Finger Route](/docs/cpp/examples/routing-navigation/finger-route.md): Render a route on the interactive map by drawing it, tracing with a finger.
- [GPX NMEA Playback](/docs/cpp/examples/routing-navigation/gpx-nmea-playback.md): In this guide you will learn:
- [GPX Routing Simulation](/docs/cpp/examples/routing-navigation/gpx-routing-simulation.md): In this guide you will learn:
- [Low-End CPU Navigation](/docs/cpp/examples/routing-navigation/low-end-cpu-navigation.md): Adjust navigation properties for low-end embedded devices with limited resources.
- [Play Route](/docs/cpp/examples/routing-navigation/play-route.md): Playback a previously recorded or generated GPS log navigation as input.
- [Route Direction Arrows](/docs/cpp/examples/routing-navigation/route-direction-arrows.md): In this guide you will learn how to render arrows on the route, indicating the direction of travel, and also set their color. RoutingService is used to compute a route and NavigationService to start a real or simulated navigation on that route, with the route direction arrows layer activated. The Route Direction Arrows layer must be added to the map style used for rendering the map.
- [Save GPX](/docs/cpp/examples/routing-navigation/save-gpx.md): In this guide you will learn how to save map matched improved positions obtained during a real or simulated navigation, in GPX format.
- [Simulate Navigation](/docs/cpp/examples/routing-navigation/simulate-navigation.md): In this guide you will learn how to calculate a route, render it on an interactive map, and simulate navigation on that route.
- [Activation Service](/docs/cpp/guides/activation-service.md): The Magic Lane Activation Service API is a C++ interface for securely activating licenses in Magic Lane SDK-based products.
- [Alarms](/docs/cpp/guides/alarms.md): In modern mobile applications, providing real-time notifications and alerts is crucial for ensuring a seamless user experience, especially in location-based services. The SDK offers a robust alarm system that enables developers to monitor and respond to various events based on the user's location, speed, and interactions with geographical boundaries or landmarks.
- [Areas alarms](/docs/cpp/guides/alarms/areas-alarms.md): Trigger operations when users enter or exit defined geographic areas using the built-in AlarmService class.
- [Get started with Alarms](/docs/cpp/guides/alarms/get-started-alarms.md): The alarm system within the C++ SDK offers a range of monitoring and notification functionalities. It allows for the detection and management of different types of alarms, such as boundary crossings, speed limit violations, and landmark alerts. The system provides the ability to configure parameters like alarm distance, overspeed thresholds, and whether monitoring should occur even without a route being followed.
- [Landmark and overlay alarms](/docs/cpp/guides/alarms/landmark-and-overlay-alarms.md): The AlarmService can be configured to send notifications upon approaching specific landmarks or overlay items within a defined proximity. This behavior can be tailored to trigger notifications exclusively during navigation or simulation modes, or while freely exploring the map without a predefined route.
- [Other alarms](/docs/cpp/guides/alarms/other-alarms.md): Receive alerts for environmental changes such as entering or exiting tunnels and transitions between day and night.
- [Speed warnings](/docs/cpp/guides/alarms/speed-alarms.md): The SDK provides features for monitoring and notifying users about speed limits and violations. You can configure alerts for when a user exceeds the speed limit, when the speed limit changes on the new road segment with respect to the previous, and when the user returns to a normal speed range (onNormalSpeed). The SDK also allows you to set customizable thresholds for speed violations, which can be adjusted for both city and non-city areas. These features help provide timely and relevant speed-related notifications based on the user's location and current speed.
- [Core](/docs/cpp/guides/core.md): The articles will guide you in working with landmarks and markers, providing a deeper understanding of predefined and user-defined points of interest, rich metadata, and dynamic annotations. Additionally, you’ll learn how to integrate layered map data through overlays and create navigable routes for various use cases. Finally, you’ll delve into real-time navigation system entities, capable of supporting turn-by-turn guidance and route simulation to enhance user experience.
- [Base entities](/docs/cpp/guides/core/base-entities.md): On this page, we present the simpler ones (coordinates, position, path, geographic areas), while in the following pages we cover the more complex ones (landmarks, markers, overlays, routes).
- [Landmarks](/docs/cpp/guides/core/landmarks.md): 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.
- [Landmarks vs Markers vs Overlays](/docs/cpp/guides/core/landmarks-markers-overlays.md): 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:
- [Markers](/docs/cpp/guides/core/markers.md): A marker is a visual representation (such as an icon or a geometry, like a polyline or polygon) placed at a specific geographic location on a map to indicate an important point of interest, event, or location.
- [Navigation instructions](/docs/cpp/guides/core/navigation-instructions.md): The Maps SDK for C++ offers comprehensive real-time navigation guidance, providing detailed information on the current and upcoming route, including road details, street names, speed limits, and turn directions. It delivers essential data such as remaining travel time, distance to destination, and upcoming turn or road information, ensuring users receive accurate, timely instructions. Designed for both navigation and simulation scenarios, this feature enhances the overall user experience by supporting smooth and efficient route planning and execution.
- [Overlays](/docs/cpp/guides/core/overlays.md): An Overlay is an additional map layer, either default or user-defined, with data stored on Magic Lane servers, accessible in online and offline modes, with few exceptions.
- [Positions](/docs/cpp/guides/core/positions.md): The sense::IImprovedPosition classes provide a comprehensive representation of geographical and movement data for GPS-based systems. They include details like coordinates, speed, altitude, direction, and accuracy, along with road-related metadata such as speed limits and modifiers. With robust support for position quality assessment and timestamped data, it is well-suited for navigation and sensor-driven applications.
- [Routes](/docs/cpp/guides/core/routes.md): A Route usually represents a navigable path between two or more landmarks (waypoints). It includes data such as distance, estimated time, and navigation instructions.
- [Traffic Events](/docs/cpp/guides/core/traffic-events.md): The Maps SDK for C++ provides real-time information about traffic events, such as delays, which can occur in various forms.
- [Driver Behaviour](/docs/cpp/guides/driver-behaviour.md): The Driver Behaviour feature enables the analysis and scoring of a driver's behavior during a trip, identifying risky driving patterns and summarizing them with safety scores. This feature tracks both real-time and session-level driving events, such as harsh braking, cornering, or ignoring traffic signs, and evaluates overall risk using multiple criteria.
- [Fleet management](/docs/cpp/guides/fleet-management.md): Fleet management
- [Configuration Parameters](/docs/cpp/guides/fleet-management/configuration-parameters.md): Configuration Parameters class in Fleet Management SDK define key settings that influence the behavior of the route optimization process. These settings determine aspects such as optimization goals, search time limits, and flexibility in handling orders. Proper configuration ensures that the algorithm meets the operational constraints of the routing problem.
- [Customers](/docs/cpp/guides/fleet-management/customer.md): The Customer class is a core component of the Fleet Management SDK, allowing users to create, manage, and retrieve customer data. Customers represent entities that place orders and serve as primary points for delivery or pickup. Each customer has a unique identity and a defined location, ensuring accurate routing and logistics optimization.
- [Fuel Prices](/docs/cpp/guides/fleet-management/fuel-prices.md): Overview
- [Introduction](/docs/cpp/guides/fleet-management/introduction.md)
- [Overview](/docs/cpp/guides/fleet-management/introduction/overview.md): Built into the Maps SDK for C++, Magic Lane's Fleet Management SDK provides a high-performance VRP optimization engine - exposing a flexible C++ API that models customers, orders, departures and destinations, vehicles, territories, fuel costs, and custom constraints - to automatically generate cost- and time-efficient fleet and delivery routes, online or offline.
- [Progress Tracking](/docs/cpp/guides/fleet-management/introduction/progress-tracking.md): What is a ProgressListener?
- [Workflow](/docs/cpp/guides/fleet-management/introduction/workflow.md): <CodeBlockWithLink
- [Miscellaneous Location](/docs/cpp/guides/fleet-management/misc-location.md): The MiscLocation class allows users to manage miscellaneous locations in the Fleet Management SDK. MiscLocations are points of interest, depots, or other locations relevant to logistics and route optimization. This API provides endpoints to:
- [Optimizations](/docs/cpp/guides/fleet-management/optimization.md): The Optimization class is a core component of the Fleet Management SDK. An optimization represents a set of orders, vehicles, constraints, and other parameters that define a routing problem. Whenever an optimization operation - such as creating, updating, or reoptimizing - is performed, it returns a Request object. This object allows you to track the status and progress of the operation asynchronously. It includes details such as the request ID, creation time, associated entity, status, and any error messages. Once the request is completed, the resulting solution can be retrieved. For more information about request handling, see the end of this page.
- [Orders](/docs/cpp/guides/fleet-management/order.md): The Order class provides functionalities for managing orders within the VRP system. An order represents a pickup or delivery request and contains information such as location, customer details, time constraints, and priority settings. The API allows users to:
- [Routes](/docs/cpp/guides/fleet-management/route.md): The Route class provides functionalities for managing and optimizing routes within a Vehicle Routing Problem (VRP) solution. A route represents the trip that a vehicle takes to visit a set of orders, and it is part of an optimization solution. The API allows users to:
- [Service](/docs/cpp/guides/fleet-management/service.md): The Service is the core component of the VRP (Vehicle Routing Problem) system, managing various operations such as creating, updating, retrieving, and deleting objects like customers, vehicles, orders, territories, and miscellaneous locations.  It also handles routes optimization, ensuring efficient deliveries and pickups. The Service class acts as a bridge between the backend system and users by handling asynchronous operations through listeners.
- [Territories](/docs/cpp/guides/fleet-management/territory.md): The Territory class enables users to manage geographical areas within the VRP system. Territories are used to define service areas, organize operations, and manage orders within specific regions. This API provides endpoints to:
- [Vehicles](/docs/cpp/guides/fleet-management/vehicle.md): The Vehicle class enables users to manage their fleet efficiently within the Fleet Management SDK. Vehicles play a crucial role in optimizing logistics and route planning. This API provides endpoints to:
- [Vehicle Constraints](/docs/cpp/guides/fleet-management/vehicle-constraints.md): Vehicle Constraints class in Fleet Management SDK define the limitations and requirements applied to a vehicle during the route optimization process. These constraints ensure that the vehicle operates within its capabilities, such as capacity, distance, and revenue limits. Properly configuring these constraints ensures that the optimization algorithm generates feasible and efficient routes for the vehicle.
- [Get started](/docs/cpp/guides/get-started.md): The Magic Lane SDKs enable developers to build advanced navigation and mapping applications with minimal setup. The guides below walk you through creating an API key, integrating the SDK of your choice, building your first application, and following best practices for optimal performance.
- [Coding with AI](/docs/cpp/guides/get-started/coding-with-ai.md): Use LLM-friendly documentation files and AI coding assistants to accelerate development with the Magic Lane Maps SDK for C++.
- [Create your first app](/docs/cpp/guides/get-started/create-first-app.md): The guide will walk you through the steps to create a simple C++ application that displays a map using the MagicLane Maps SDK.
- [Integrate the SDK](/docs/cpp/guides/get-started/integrate-sdk.md): This guide walks you through downloading and integrating the Magic Lane C++ SDK into your project.
- [Internationalization](/docs/cpp/guides/get-started/internationalization.md): The Magic Lane SDK for C++ provides extensive multilingual and localization support, ensuring seamless integration for global applications.
- [Optimization best practices](/docs/cpp/guides/get-started/optimization-best-practices.md): This guide highlights key strategies to improve app performance and resource management when using the Magic Lane SDK for C++.
- [Usage guidelines](/docs/cpp/guides/get-started/usage-guidelines.md): This page covers recommended usage guidelines for the Maps SDK for C++. Following these practices helps ensure code reliability and prevents common integration pitfalls.
- [Maps SDK for C++](/docs/cpp/guides/introduction.md): The Maps SDK for C++ offers a powerful and comprehensive set of features that enable developers to integrate seamless mapping and navigation experiences into their applications
- [Minimum requirements](/docs/cpp/guides/introduction/minimum-requirements.md): Development Machine
- [Location Wikipedia](/docs/cpp/guides/location-wikipedia.md): Landmarks can include Wikipedia data such as title, image title, URL, description, page summary, and language. The ExternalInfo class handles Wikipedia data.
- [Maps](/docs/cpp/guides/maps.md): Through this series, we’ll take you step-by-step into key concepts such as adjusting map views, interacting with maps using gestures, and implementing personalized styles. Additionally, you’ll discover how to handle map overlays, markers, routes, and navigation, all while ensuring a smooth and engaging user experience. Whether you’re a seasoned developer or new to mapping technology, this guide will empower you to build innovative, map-driven applications with ease.
- [Adjust the map view](/docs/cpp/guides/maps/adjust-map.md): The Maps SDK for C++ provides multiple ways to modify the map view, center on coordinates or areas, including `MapView` functionality for exploring different perspectives.
- [Display map items](/docs/cpp/guides/maps/display-map-items.md): This collection of articles covers a wide range of features and techniques for displaying various elements on a map within a mobile application, including landmarks, markers, overlays, routes, instructions, and paths.
- [Display landmarks](/docs/cpp/guides/maps/display-map-items/display-landmarks.md): When displaying the map, we can choose what types of landmarks we want to display. Each landmark can have one or more LandmarkCategory. To selectively display specific categories of landmarks programmatically, you can use the addStoreCategoryId method provided by the LandmarkStoreCollection class:
- [Display markers](/docs/cpp/guides/maps/display-map-items/display-markers.md): The base class for the marker hierarchy is Marker. It encapsulates coordinates assigned to a specific part. Multiple coordinates can be added to the same marker and be separated into different parts. If no part is specified, the coordinates are added to a default part, indexed as 0. The coordinates are stored in a list-like structure, where you can specify their index explicitly. By default, the index is set to -1, meaning the coordinate will be appended to the end of the list.
- [Display overlays](/docs/cpp/guides/maps/display-map-items/display-overlays.md): Overlays are used to provide enhanced, layered information that adds contextual value to a base map, offering users dynamic, interactive, and customized data that can be visualized on top of other map elements.
- [Display paths](/docs/cpp/guides/maps/display-map-items/display-paths.md): Paths can be displayed by adding them into `MapViewPathCollection. The MapViewPathCollection is an iterable collection, having fields like size, add, remove, removeAt, getPathAt and getPathByName`.
- [Display route instructions](/docs/cpp/guides/maps/display-map-items/display-route-instructions.md): Instructions are represented as arrows on the map and can be displayed by using `MapView:
- [Display routes](/docs/cpp/guides/maps/display-map-items/display-routes.md): Routes can be displayed on the map by using `preferences().routes().add(route, isMainRoute). Multiple routes can be displayed at the same time, but only one is the main one, the others being treated as secondary. Specifying which one is the main route can be done when calling MapViewRouteCollection::setMainRoute` setter.
- [Get started with maps](/docs/cpp/guides/maps/get-started.md): The Maps SDK for C++ delivers powerful mapping capabilities, enabling developers to effortlessly integrate dynamic map views into their applications. Core features include embedding and customizing map views, controlling displayed locations, and fine-tuning map properties. At the center of the mapping API is the MapView, a subclass of Canvas, offering a wide range of configurable options.
- [Interact with the map](/docs/cpp/guides/maps/interact-with-map.md): The Maps SDK for C++ map view natively supports common touch events click and double-click for zooming. The table below outlines the available gestures and their default behaviors on the map.
- [Styling](/docs/cpp/guides/maps/styling.md): The appearance of the map can be tailored by applying different styles. You can either download a predefined map style using the `ContentStore` class, which offers a variety of ready-to-use styles, or create a custom style using Magic Lane Map Studio which you can download and configure. In this guide, we’ll explore both methods in detail.
- [Navigation](/docs/cpp/guides/navigation.md): The Magic Lane Maps SDK for C++ provides a complete toolkit for building turn-by-turn navigation applications. Key features include live guidance, offline support, and real-time alerts for speed limits, traffic conditions, and route deviations with automatic recalculation. A built-in location simulator is also available for testing during development.
- [Better route detection](/docs/cpp/guides/navigation/better-route-detection.md): The Maps SDK for C++ continuously monitors traffic conditions and automatically evaluates alternative routes to ensure optimal navigation. This feature enhances user experience by providing real-time route adjustments, reducing travel time, and improving overall efficiency, especially in dynamic traffic environments.
- [Get started with Navigation](/docs/cpp/guides/navigation/get-started-navigation.md): The Maps SDK for C++ provides developers with comprehensive tools to build a robust turn-by-turn navigation system. This functionality enables applications to track the current device location relative to a predefined route and deliver real-time navigational guidance.
- [Roadblocks](/docs/cpp/guides/navigation/roadblocks.md): A roadblock is a user-defined restriction applied to a specific road segment or geographic area, used to reflect traffic disruptions such as construction, closures, or areas to avoid.
- [Offline](/docs/cpp/guides/offline.md): The SDK provides extensive offline functionality through downloadable map regions. Once downloaded, users can search for landmarks, calculate and navigate routes, and explore the map -- all without an active internet connection. The SDK also supports downloading and managing additional content such as maps and styles.
- [Introduction](/docs/cpp/guides/offline/introduction.md): The Maps SDK for C++ provides extensive offline functionality through its map download capabilities. Users can search for landmarks, calculate and navigate routes, and explore the map without requiring an active internet connection.
- [Manage Content](/docs/cpp/guides/offline/manage-content.md): The Maps SDK for C++ offers comprehensive functionality for managing offline content.
- [Update Content](/docs/cpp/guides/offline/update-content.md): The Magic Lane Maps SDK for C++ allows updating downloaded content to stay synchronized with the latest map data. New map versions are released every few weeks.
- [Positioning & Sensors](/docs/cpp/guides/positioning.md): The Positioning module provides powerful tools for managing location data in your app, enabling features like navigation, tracking, and location-based services. It offers flexibility by supporting both real GPS data and custom location sources, allowing for dynamic and accurate position tracking. In addition, the Recorder module complements the Positioning capabilities by enabling the recording of sensor data. With customizable settings, it allows you to tailor the recording process for various data types, such as video, audio, or sensor information.
- [Custom positioning](/docs/cpp/guides/positioning/custom-positioning.md): The Maps SDK for C++ allows setting custom data source with the PositionService to dynamically manage and simulate location data. This approach allows for external or simulated positioning data, providing flexibility beyond traditional GPS signals, and is ideal for testing or custom tracking solutions.
- [Get started with positioning](/docs/cpp/guides/positioning/get-started-positioning.md): The Positioning module enables your application to obtain and utilize location data, serving as the foundation for features like navigation, tracking, and location-based services. This data can be sourced either from the device's GPS or from a custom data source, offering flexibility to suit diverse application needs.
- [Projections](/docs/cpp/guides/positioning/projections.md): Besides the Coordinates class, the Maps SDK for C++ provides a Projection class that represents the base class for different geocoordinate systems such as:
- [Recorder](/docs/cpp/guides/positioning/recorder.md): The Recorder module is a comprehensive tool designed for managing sensor data recording.
- [Sensors and data sources](/docs/cpp/guides/positioning/sensors-and-data-sources.md): This section provides an overview of how the Maps C++ SDK integrates with various sensors and external data sources to enhance map functionality and interactivity. From GPS and compass data to accelerometer readings and custom telemetry inputs, the SDK is designed to support a wide range of sensor-driven scenarios.
- [Show location on map](/docs/cpp/guides/positioning/show-your-location-on-the-map.md): The location of the device is shown by default using an arrow position tracker. If a DataSource has been successfully set in PositionService and is being fed regularly with new position data objects then the position tracker showing the current location should be visible on the map as an arrow.
- [Public Transit Stops](/docs/cpp/guides/public-transit-stops.md): This API provides access to public transport data including agencies, routes, stops, and trips. Fetch and explore real-time public transportation information from selected positions on the map.
- [Routing](/docs/cpp/guides/routing.md): Routing functionality provides a robust solution for calculating, customizing, and analyzing routes for various transportation needs. You can calculate routes between a start and destination point, include intermediate waypoints for multi-stop routes, and determine areas accessible within a specific range. Additionally, the routing service allows you to retrieve turn-by-turn instructions, traffic event details, and estimate time of arrival (ETA) along with travel durations and distances. The system supports a variety of options such as computing terrain profiles for elevation data, displaying routes on a map, and handling public transit routes.
- [Advanced features](/docs/cpp/guides/routing/advanced-features.md): In order to compute a route range we need to:
- [Get started with routing](/docs/cpp/guides/routing/get-started-routing.md): Here’s a quick overview of what you can do with routing:
- [Roundtrips](/docs/cpp/guides/routing/roundtrips.md): The Routing API offers the ability to generate a random route, starting at a given waypoint and back to that same point.
- [Route Bookmarks](/docs/cpp/guides/routing/route-bookmarks.md): This guide explains how to store, manage, and retrieve route collections as bookmarks between application sessions.
- [Handling RoutePreferences](/docs/cpp/guides/routing/route-preferences.md): Before computing a route, we need to specify some route options.
- [Search](/docs/cpp/guides/search.md): The SDK supports several search methods including text search, proximity search, and category-based search, with customizable preferences like fuzzy matching and distance limits. Additionally, users can search for custom landmarks or within overlays. For geocoding, the SDK provides reverse geocoding, converting geographic coordinates into comprehensive address details, and geocoding, which allows locating specific places based on address components. The SDK also offers integration with Wikipedia for location-based content, and auto-suggestions to dynamically generate search results while typing.
- [Getting started with Search](/docs/cpp/guides/search/get-started-search.md): The Maps SDK for C++ provides a flexible and robust search functionality, allowing the search of locations using text queries and coordinates:
- [Search & Geocoding features](/docs/cpp/guides/search/search-geocoding-features.md): This guide explains how to use geocoding and reverse geocoding features to convert coordinates to addresses and vice versa, search along routes, and implement auto-suggestions.
- [Settings Service](/docs/cpp/guides/settings-service.md): The Settings Service stores key-value pairs in permanent storage using the SettingsService class. Settings are saved in a .ini file format.
- [Social reports](/docs/cpp/guides/social-reports.md): Social reports are user-generated alerts about real-time driving conditions or incidents on the road, including accidents, police presence, road construction, and more.
- [Timezone service](/docs/cpp/guides/timezone-service.md): The TimezoneService provides functionality for managing and retrieving time zone information.
- [Weather](/docs/cpp/guides/weather.md): The WeatherService class provides a full range of weather data access, from current conditions to hourly and daily forecasts. Supported parameters include temperature, air quality, atmospheric pressure, wind speed, UV index, and more.
- [Base Entities](/docs/cpp/guides/weather/base-entities.md): Weather-related functionalities are organized into distinct classes, each designed to encapsulate specific weather data.
- [Weather Service](/docs/cpp/guides/weather/weather-service.md): The WeatherService class provides methods for retrieving current, hourly, and daily weather forecasts.