Put a real map in your application without a browser control or a line of JavaScript. sgcMaps draws raster and vector tiles itself, shows thousands of clustered markers, routes and zones, geocodes addresses, and keeps working offline with local tiles and an offline router.
Thirteen features, each with the real API and the help topic behind it.
The map control draws every tile itself, from a tile server, a vector source or files on disk.
Tiles and map data
Most map components wrap a web view and a JavaScript library, so your desktop application ends up shipping a browser. sgcMaps does not. TsgcVCLMap and TsgcFMXMap download, cache and draw the tiles on their own canvas, handle mouse wheel zoom and drag to pan, and raise normal Delphi events. Your map is a native control like any other: it docks, it themes with the form and it debugs like the rest of your code. There is no extra process to deploy or to secure, and the map behaves the same on every machine your application runs on.
Layers collection holds one or more TsgcMapLayer items, each with its own TileSourceTypeTsgcFMXMap runs on Windows, macOS, iOS and Android from Delphi XE6SgcMapControl for WinForms and the headless MapView share one engine
Tiles and map data
Choosing a base map should not mean reading tile server documentation. Set Provider on a layer and call sgcMapApplyProvider: the layer gets the URL template, the maximum zoom and the attribution text of that provider. OpenStreetMap, OpenTopoMap, Esri World Imagery and Esri World Street work without a key. MapTiler, Thunderforest and Stadia take your own API key. Your own tile server is one URL template away. Each layer has its own provider, so a satellite layer and a street layer can sit in the same map and the user switches between them on the map itself.
mtpOpenStreetMap, mtpOpenTopoMap, mtpEsriWorldImagery, mtpEsriWorldStreetmtpMapTilerStreets, mtpMapTilerSatellite, mtpThunderforestCycle, mtpThunderforestTransport, mtpStadiaAlidadeSmoothmtpCustom with URLTemplate reads any {z}/{x}/{y} serverShowLayerSwitcher puts a layer button on the map
Tiles and map data
Raster tiles blur when you scale them, and every style change means new images from the server. With vector tiles the control receives the geometry and draws roads, water, buildings and labels itself, so text stays crisp on high DPI screens and in exported images. Point a layer at a Mapbox Vector Tile server and leave VectorStyleFile empty to use the built in style, or load a MapLibre or Mapbox GL style file to match your brand. Vector layers work in the VCL and the FireMonkey control alike.
mtsVectorHTTP reads a vector tile server, from Delphi XE2mtsVectorMBTiles reads a local vector MBTiles file (offline pack)TsgcMapVectorStyle loads a style with LoadFromFile or LoadFromJSONTsgcMapTileSource_MVT, in plain Delphi codeTiles and map data Registered only
A field technician in a basement, a vessel at sea or a plant floor network cannot depend on a tile server. sgcMaps reads tiles from disk exactly as it reads them from the web. Give a layer a CacheFolder and every tile it fetches is kept for the next run. For a complete offline pack, TsgcMapTileDownloader fetches an area and a zoom range ahead of time into a folder or an MBTiles file.
mtsFolder reads a z/x/y folder of PNG or JPEG tilesmtsMBTiles reads a raster MBTiles file, from Delphi XE7 (FireDAC SQLite)CountTiles tells you the size of a download before you start it; DelayMS and OnProgress keep it polite and visibleCommunity reads z/x/y tile folders and keeps the per layer CacheFolder. The tile downloader and MBTiles files belong to the offline pack.
Read the help topicPut your own data on the map, keep it readable at every zoom level and do the math behind it.
Markers, shapes and geometry
A fleet, a store network or a sensor grid quickly turns into a cloud of overlapping pins. Turn on clustering and nearby markers merge into one numbered bubble that splits again as the user zooms in, recomputed at every zoom level. Each marker carries its own popup, tooltip and icon, and clicks, drags and cluster clicks arrive as events, so the map becomes part of your workflow instead of a picture. Markers can be added in a loop from your data or imported from GeoJSON, GPX and KML files, and ClearMarkers resets them in one call.
MarkerOptions.Clustering with GridSize, MinClusterSize and ZoomOnClickPopupText, TooltipText and IconBitmap per markerOnMarkerClick, OnClusterClick and OnMarkerDragEnd eventsBeginUpdate and EndUpdate around bulk loads; FitToMarkers frames them allMarkerAtScreen and ClusterAtScreen hit test any pixel
Markers, shapes and geometry
Most map screens need more than pins: the planned delivery route, the area a depot serves, a radius around a customer, where the orders come from. sgcMaps draws all of them as items of the map model, in the same coordinates as your markers. Shapes can be made editable, so a user can drag the vertices of a zone with the mouse and your code is told when the edit ends. Labels place text at a coordinate with their own font, color and background, which keeps zone names and route numbers attached to the map.
AddPolyline with Dashed and Geodesic linesAddPolygon with AddHole, plus AddRectangle, AddCircle (RadiusMeters) and AddLabelEditable shapes report changes through OnShapeEditedTsgcMapHeatmap takes weighted points with AddPoint and a MaxIntensityMarkers, shapes and geometry
Is this vehicle inside the zone? How far is the nearest depot? Which point of the route is closest to the customer? These questions come up in every map application and are easy to get wrong near the poles or across long distances. The geometry unit answers them on the WGS84 sphere with plain functions you can also call from a service with no map at all. The functions take plain TsgcMapCoord records, and sgcMapLatLonToPixel and sgcMapPixelToLatLon convert between screen and world coordinates when you draw your own overlays.
sgcMapDistance in meters, sgcMapInitialBearing and sgcMapDestinationPointsgcMapPointInPolygon and sgcMapPointInPolygonWithHoles for geofencessgcMapNearestPointOnPolyline snaps a position to a routesgcMapGeodesicInterpolate and sgcMapSimplify for smooth, light linesFind addresses and plan routes with online providers, or fully offline with no API key.
Search and routing
Every geocoding and routing provider has its own REST format, keys and quirks. The service components hide them: you pick a provider, set your key when it needs one and call the same methods, synchronously or async. Switching from one provider to another is a property change, not a rewrite, and results come back as Delphi objects ready to put on the map. Every component shares the TsgcMapService base class, so ApiKey, UserAgent and LastError work the same way for every provider.
TsgcMapGeocoder: Nominatim, Google, HERE, Azure Maps, Mapbox, OpenRouteService and GeoapifyTsgcMapDirections: OSRM, OpenRouteService, Google Routes, HERE, Azure Maps, Mapbox and GeoapifyTsgcMapPlaces for address autocomplete, TsgcMapElevation and TsgcMapTimeZoneGeocodeAsync, GetRouteAsync and SuggestAsync keep the UI responsive; errors arrive in OnErrorSearch and routing Registered only
Online routing fails exactly where field apps are used, and every request may cost money. The offline router computes car, bike and foot routes on the device from a route graph built once from an OpenStreetMap extract. The offline geocoder searches place names and reverse geocodes a click from a GeoNames index in SQLite. Both run with no network, no account and no per request fee. The router and the geocoder are non visual components, so a Windows service or a console tool can answer route and address requests with no map on screen.
TsgcMapOfflineRouter answers GetRoute from a graph built by TsgcMapRouteGraphBuilder from .osm.pbfsgcMapAddRouteToPolylines draws the result on the mapTsgcMapOfflineGeocoder with ReverseGeocode, over an index from TsgcMapGeoIndexBuilderCommunity uses the online services; the offline router and geocoder belong to the offline pack.
Read the help topicExchange geodata with other tools, render maps where there is no screen, and take the map to a phone.
Files, rendering and mobile
Customers send tracks from a GPS watch, zones drawn in a GIS tool or a KML from another system. sgcMaps reads and writes GeoJSON, GPX and KML straight into the map model, so an import is one call and an export is another. GPX tracks come with their statistics and can be colored by elevation, and a streaming reader walks large OpenStreetMap extracts without loading them into memory. Exports use the same functions in reverse, so zones a user drew on the map can be saved as GeoJSON or KML and opened in other GIS tools.
sgcMapLoadGeoJSONFile and sgcMapSaveGeoJSONFile, from Delphi XE6TsgcMapGPX with TrackStats (TotalAscent, TotalDescent) and ColorByElevationsgcMapLoadKMLFile and sgcMapSaveKMLFilesgcMapGeoJSONAsText returns the GeoJSON of the map as a string
Files, rendering and mobile
Delivery notes with the route, a daily report with today's incidents, a thumbnail for a web page: many maps are never shown in a window. The same control renders to a PNG or a bitmap without being visible, from a console application or a Windows service. You can check whether every tile arrived before you send the image, so a slow tile server never ends up as a grey square in a customer document. Server side rendering uses the same layers, markers and shapes as the interactive control, so a map designed on screen looks the same in the PNG.
SaveToPNG and SaveToPNGFile, from Delphi 2009RenderToBitmap and SaveToBMPFile for your own pipelineLastRenderMissingTiles reports tiles that were not availableMapView.RenderToPng also runs on LinuxFiles, rendering and mobile
A dispatcher plans on a Windows desktop and the driver follows the plan on a phone. TsgcFMXMap brings the same model, layers, markers, shapes and services to FireMonkey on Windows, macOS, iOS and Android, so the code you wrote for the VCL map carries over. TsgcMapLocation reads the position of the device, so the map can center on the user and follow them. The per layer tile cache works on mobile too, so a phone keeps showing the areas it has already loaded.
TsgcFMXMap from Delphi XE6, with the same collections as TsgcVCLMapTsgcMapLocation on Windows, Android, iOS and macOSThe preview shows exactly what the printer and the PDF get.
Print, preview and PDF
The map prints on one page as a picture of the current view: the same area as the control, with its centre, its zoom, the tiles, the layers, the markers and the shapes. The scale bar and the attribution are printed, the zoom buttons, the layer switcher and the compass are not, and printing never moves the view.
Print shows the print dialog or prints straight to the default printer, and ShowPrintPreview opens a preview with page navigation, zoom, page setup, printing and PDF exportPrintSettings holds the paper, the orientation, the margins, the scaling and the header and footer text, and the printer, the preview and the PDF all use itExportToPDF writes the page as one tagged picture, 192 dpi by default, with an alternative text that gives the centre, the zoom and the number of layers and markersPDFALevel of TsgcUIPDFOptions adds PDF/A-2a or PDF/A-3a for archiving, alone or together with PDF/UAPrinting and the preview are in every edition, the free Community edition included, on VCL, FireMonkey and WinForms. In FireMonkey, printing works on Windows and macOS, and the preview and the PDF export on every platform. The PDF export needs the sgcUIPDF bridge and a licensed sgcPDF (the NuGet package esegece.sgcUICore.sgcPDF in .NET), so it is not in the Community edition.
UI Automation for screen readers and the keyboard, with no setup.
Accessibility
sgcMaps exposes the map to Microsoft UI Automation with a text alternative, the markers as a list and the layers as a list, where each layer reports whether it is visible. The markers can be reached with the keyboard.
Accessibility is on by default in every edition, the free Community edition included, on VCL in every Delphi and C++Builder version from Delphi 7 to Delphi 13, on FireMonkey on Windows, and on WinForms. In Delphi and C++Builder, AccessibleName and AccessibleDescription set the name and the description exposed to UI Automation, and in .NET the standard accessible name and help text of each framework do the same. See the accessibility conformance reports. The map image is described by its centre and zoom only, and the map renderer does not follow Windows high contrast, because the map image is tile imagery from the provider.
sgcMaps inside the sgcUI suite demos: complete applications that run offline with built-in simulated data.
48 vehicles, their routes and a closure polygon on one map.
Altamira Fleet →
City rounds and delivery stops at street level.
Altamira Fleet →
Four plants as status markers with output per site.
Altamira Plant →
Project sites as markers coloured by RAG status.
Altamira PMO →
Technicians and drivers need the map where coverage is poor. Prepare the tiles of a region ahead of time, compute car routes on the device with the offline router and find addresses with the offline geocoder. Back at the office, the same code draws the planned routes and delivery zones, and renders a PNG of each route for the delivery note.
A control room watches hundreds of vehicles, machines or sensors at once. Clustering keeps the map readable at country level and splits into single pins at street level. A heatmap shows where incidents concentrate, geofence checks with point in polygon raise alerts, and marker click events open the record of the asset in your own forms.
Planning tools, sports apps and survey software live on GPX tracks, KML layers and GeoJSON zones. sgcMaps imports and exports all three, shows track statistics and elevation colors, and puts the result on a topographic base map. The FireMonkey control takes the same features to a tablet or a phone in the field. Track statistics give the total ascent and descent of a route at a glance.
The same API in Delphi, C++ Builder and C#: OpenStreetMap tiles, three markers, a geodesic line and a radius, fitted to the markers and saved as PNG.
A VCL map built in code: a cached OpenStreetMap layer, markers, a geodesic line and a circle, then a PNG of the result.
uses
SysUtils, Controls, Graphics, sgcMaps_Classes, sgcMaps_Providers,
sgcMaps_Geometry, sgcMaps_VCL;
// OpenStreetMap with cached tiles, three capitals, a geodesic flight line
// and a 300 km radius, fitted to the markers and saved as PNG.
procedure BuildMap(aOwner: TWinControl);
var
oMap: TsgcVCLMap;
oLayer: TsgcMapLayer;
oLine: TsgcMapPolyline;
begin
oMap := TsgcVCLMap.Create(aOwner);
oMap.Parent := aOwner;
oMap.Align := alClient;
oLayer := oMap.Layers.Add;
oLayer.Name := 'OpenStreetMap';
oLayer.Provider := mtpOpenStreetMap;
sgcMapApplyProvider(oLayer);
oLayer.CacheFolder := ExtractFilePath(ParamStr(0)) + 'tile_cache';
oMap.AddMarker(48.8566, 2.3522, 'Paris', 'France');
oMap.AddMarker(52.5200, 13.4050, 'Berlin', 'Germany');
oMap.AddMarker(41.9028, 12.4964, 'Rome', 'Italy');
oMap.MarkerOptions.Clustering.Enabled := True;
oLine := oMap.AddPolyline;
oLine.Geodesic := True;
oLine.Dashed := True;
oLine.Color := clRed;
oLine.AddPoint(48.8566, 2.3522);
oLine.AddPoint(52.5200, 13.4050);
oMap.AddCircle(48.8566, 2.3522, 300000).FillOpacity := 0.15;
oMap.FitToMarkers(40);
oMap.AddLabel(50.7, 8, Format('Paris to Berlin: %.0f km',
[sgcMapDistance(48.8566, 2.3522, 52.52, 13.405) / 1000]));
oMap.SaveToPNG('europe.png', 1200, 800);
end;The same map in C++ Builder with the generated sgcMaps headers.
#include <vcl.h>
#include "sgcMaps_Classes.hpp"
#include "sgcMaps_Providers.hpp"
#include "sgcMaps_Geometry.hpp"
#include "sgcMaps_VCL.hpp"
// OpenStreetMap with cached tiles, three capitals, a geodesic flight line
// and a 300 km radius, fitted to the markers and saved as PNG.
void BuildMap(TWinControl *aOwner)
{
TsgcVCLMap *oMap = new TsgcVCLMap(aOwner);
oMap->Parent = aOwner;
oMap->Align = alClient;
TsgcMapLayer *oLayer = oMap->Layers->Add();
oLayer->Name = "OpenStreetMap";
oLayer->Provider = mtpOpenStreetMap;
sgcMapApplyProvider(oLayer);
oLayer->CacheFolder = ExtractFilePath(ParamStr(0)) + "tile_cache";
oMap->AddMarker(48.8566, 2.3522, "Paris", "France");
oMap->AddMarker(52.5200, 13.4050, "Berlin", "Germany");
oMap->AddMarker(41.9028, 12.4964, "Rome", "Italy");
oMap->MarkerOptions->Clustering->Enabled = true;
TsgcMapPolyline *oLine = oMap->AddPolyline();
oLine->Geodesic = true;
oLine->Dashed = true;
oLine->Color = clRed;
oLine->AddPoint(48.8566, 2.3522);
oLine->AddPoint(52.5200, 13.4050);
oMap->AddCircle(48.8566, 2.3522, 300000)->FillOpacity = 0.15;
oMap->FitToMarkers(40);
int iKm = (int)(sgcMapDistance(48.8566, 2.3522, 52.52, 13.405) / 1000);
oMap->AddLabel(50.7, 8, "Paris to Berlin: " + IntToStr(iKm) + " km");
oMap->SaveToPNG("europe.png", 1200, 800, false);
}The headless MapView renders the same map to a PNG file, on Windows or Linux.
using System;
using System.IO;
using esegece.sgcMaps;
using esegece.sgcMaps.Rendering;
// OpenStreetMap with cached tiles, three capitals, a geodesic flight line
// and a 300 km radius, fitted to the markers and saved as PNG (no window).
public static class EuropeMap
{
public static void Render()
{
var oMap = new MapView();
Layer oLayer = oMap.Layers.Add();
oLayer.Name = "OpenStreetMap";
oLayer.Provider = TileProvider.OpenStreetMap;
MapProviders.ApplyProvider(oLayer);
oLayer.CacheFolder = Path.Combine(AppContext.BaseDirectory, "tile_cache");
oMap.AddMarker(48.8566, 2.3522, "Paris", "France");
oMap.AddMarker(52.5200, 13.4050, "Berlin", "Germany");
oMap.AddMarker(41.9028, 12.4964, "Rome", "Italy");
oMap.MarkerOptions.Clustering.Enabled = true;
Polyline oLine = oMap.AddPolyline();
oLine.Geodesic = true;
oLine.Dashed = true;
oLine.Color = MapColors.Red;
oLine.AddPoint(48.8566, 2.3522);
oLine.AddPoint(52.5200, 13.4050);
oMap.AddCircle(48.8566, 2.3522, 300000).FillOpacity = 0.15;
oMap.FitToMarkers(40);
double vKm = MapGeometry.Distance(48.8566, 2.3522, 52.52, 13.405) / 1000;
oMap.AddLabel(50.7, 8, $"Paris to Berlin: {vKm:F0} km");
oMap.RenderToPng("europe.png", 1200, 800);
}
}dotnet add package esegece.sgcMaps.RenderingSeven Delphi demos and three .NET demos ship with sgcMaps. There are no C++ Builder demo projects.
Folder, MBTiles and online tiles, markers and shapes, plus GeoJSON, GPX and KML import.
Providers and API keys, marker clustering, shape editing, heatmaps and image export.
Place search, geocoding, directions, elevation, time zones and device location with the online providers. Delphi XE8 and later.
Build a GeoNames index and an OpenStreetMap route graph, then search places and route a car, bike or walk with no network.
A console program that renders a map to a PNG or BMP file with no window.
The FireMonkey map with tiles, markers and device location, for Windows, macOS, iOS and Android. Delphi XE6 and later.
A vector tile server drawn with the built in style or a style file of your own, with crisp labels at every zoom.
The .NET SgcMapControl in a WinForms window with providers, markers and shapes.
The .NET offline package: offline tiles, routing and geocoding from local data files.
A .NET console that renders a map to PNG with the headless MapView, on Windows or Linux.
Ready to run executables of every sgcUI product, nothing to install.
Download sgcUI_bin.zip →sgcMaps is part of sgcUI Enterprise, and it is also sold on its own. sgcMaps is also included in the All-Access bundle.
€149 / developer, full source code, 1 year of updates.
Buy sgcMaps → See pricing →The free Community edition (Delphi installer and NuGet esegece.sgcMaps.Community, esegece.sgcMaps.Rendering.Community, esegece.sgcMaps.WinForms.Community) has every feature except the offline pack. The esegece.sgcMaps.Offline package is Registered only. A project references either the Community or the Registered packages, never both.
| Feature | Community (free) | Registered |
|---|---|---|
| VCL, FireMonkey and WinForms map controls | ✓ | ✓ |
| Tile providers, HTTP and vector tile servers | ✓ | ✓ |
| z/x/y tile folders and the per layer tile cache | ✓ | ✓ |
| Markers, clustering, shapes, labels and heatmaps | ✓ | ✓ |
| Geometry functions | ✓ | ✓ |
| GeoJSON, GPX and KML import and export | ✓ | ✓ |
| Online geocoding, directions, places, elevation and time zones | ✓ | ✓ |
| Static rendering to PNG | ✓ | ✓ |
| Tile downloader for offline packs | − | ✓ |
| MBTiles files (raster and vector) | − | ✓ |
| Offline router and offline geocoder | − | ✓ |
The map controls for VCL and FireMonkey, plus a Lazarus LCL control that reads tiles from disk.
Layers, Markers, Polylines, Polygons, Rectangles, Circles, Labels and Heatmaps, shared by every framework.
TsgcMapGeocoder, TsgcMapDirections, TsgcMapPlaces, TsgcMapElevation and TsgcMapTimeZone.
TsgcMapRouteCalculator, TsgcMapOfflineRouter, TsgcMapOfflineGeocoder, TsgcMapGeoIndexBuilder and TsgcMapTileDownloader.
Device location, and sgcMapDistance, bearing, destination point, geodesic interpolation, point in polygon and line simplification.
SgcMapControl for WinForms, and MapView, the headless engine that renders to PNG, also on Linux.
| Target | Component | Platforms |
|---|---|---|
| Delphi 7 to 13, VCL | TsgcVCLMap and the model | Win32, and Win64 from XE2 |
| Delphi XE6 to 13, FireMonkey | TsgcFMXMap | Windows, macOS, iOS and Android, device location on Windows, Android, iOS and macOS |
| C++ Builder 2007 to 13 | TsgcVCLMap and the model | Generated .hpp headers and static libraries |
| Lazarus | LCL map control | Tiles from disk only, it cannot download tiles |
| .NET 8, 9 and 10 | SgcMapControl, MapView | WinForms (net8.0-windows, net9.0-windows, net10.0-windows), headless PNG on Windows and Linux |
No. The tiles, markers and shapes are drawn natively by the control, so there is no web view, no JavaScript library and no browser runtime to deploy.
Not for OpenStreetMap, OpenTopoMap and the Esri tiles, and not for the offline router and geocoder. MapTiler, Thunderforest and Stadia tiles, and the commercial geocoding and routing providers, use your own key. Every provider keeps its own usage terms, which your application has to respect.
Yes. Tiles can come from z/x/y folders, a per layer cache or MBTiles files, routes from TsgcMapOfflineRouter and address search from TsgcMapOfflineGeocoder. MBTiles, the tile downloader and the offline router and geocoder are part of the offline pack of the Registered edition.
GeoJSON, GPX and KML, for import and export, with GPX track statistics and elevation colors. A streaming reader also processes OpenStreetMap .osm.pbf and XML files, which is how the offline route graph is built. See File Formats.
The model and the VCL control work from Delphi 7 and C++ Builder 2007. Some features have a higher minimum: PNG output and tile servers from Delphi 2009, vector tiles and the offline router from XE2, FireMonkey and GeoJSON from XE6, MBTiles and the offline geocoder from XE7, online services from XE8.
The demo projects are Delphi only, but the components install in C++ Builder 2007 to 13 and work the same way. The C++ Builder tab in the code section above shows the same map built with the generated headers.
Yes. The Community edition is free for individuals and organizations under EUR 1M annual gross revenue with no more than 5 developers. It has every feature except the offline pack. On .NET the packages are esegece.sgcMaps.Community, esegece.sgcMaps.Rendering.Community and esegece.sgcMaps.WinForms.Community. Larger organizations need a Registered license.
Introduction, Overview, Quick Start VCL, TsgcVCLMap, Tiles and layers, Markers and clustering, Offline routing, Static rendering, Demos.
Delphi, C++ Builder and .NET, covering every sgcUI product.
Put the map in a dashboard tile next to KPI cards and charts, so a control room sees places and numbers together.
Explore sgcDashboard →
List the assets on the map in a live grid and center the map on the row the user selects.
Explore sgcGrid →
Render a route with SaveToPNG and print it in a delivery note or an incident report.
Explore sgcReports →