Changelog
This page records user-visible SDK changes, including smaller fixes and compatibility updates. Major features may also have a separate article in the blog.
2.0.1 — 28 July 2026
Fixed
- Text labels with an outline no longer lose their fill when duplicate-stencil suppression is enabled. The fix applies to the Metal and OpenGL renderers.
- Post offices remain available in text and category search, but no longer appear as a promoted quick category.
2.0.0 — 22 July 2026
Added
- Added offline 3D terrain with configurable altitude scale.
- Added terrain-aware tracks, markers, labels, hillshades, slope shading, and contour lines.
- Added
GLSearchRequestas one request model for online and offline text search, autocomplete, and category browsing. - Added stable identifiers to search categories.
- Added walking, hiking, wheelchair, and blind-pedestrian routing profiles.
- Added Vulkan rendering on supported Android devices with automatic OpenGL ES fallback.
- Added Android 17 and
targetSdk 37compatibility while retaining Android API 21 as the minimum. - Added watchOS build support for
GLMapCore. - Added compact Swift/UIKit and Kotlin reference applications covering maps, search, routing, terrain, downloads, markers, and camera operations.
Changed
- Online and offline search now return the same display-ready map-object model.
- Custom style parsing on iOS now reports errors; Swift
GLMapStyleParsermethods are throwing. - Fly-to animations now use
flyToModeand a map-center change inside the animation block. - Drawable hit testing now uses screen-bounds testing.
- Applications must provide WGS-84 coordinates; the legacy China-coordinate switch was removed.
- Android applications can allow GLMap to choose between Vulkan and OpenGL ES automatically.
Fixed
- Improved cancellation and exactly-once completion for search and routing requests.
- Improved handling of empty input, malformed responses, renderer recreation, and interrupted downloads.
- Improved route tracking, alternative selection, and elevation validation.
See GLMap 2.0 for the release overview and migration guidance.
1.13.0 — 16 February 2026
Added
- Added
GLMapTrackArrowfor drawing directional arrows along navigation routes and other tracks. - Added
GLMapUserLocationto manage the user-location marker, accuracy circle, images, and location updates with less application-side code.
Changed
- Simplified the iOS track and image APIs.
- Improved cross-platform API parity for route construction, map animations, and Android documentation.
- Reworked Android gesture handling and improved shader compilation caching.
Fixed
- Fixed an Android rendering and animation deadlock.
- Fixed a triangulation crash and data races in scale-ruler updates.
- Fixed iOS custom-callback memory leaks and improved map-download error handling.
See GLMap 1.13.0 for examples and migration notes.
1.12.0 — 13 July 2025
Changed
- Reworked tile loading on both platforms to progressively request detail, avoid unnecessary cancellations, and make better use of the download cache during rapid pan and zoom gestures.
- Android screen-coordinate conversion now uses
android.graphics.PointF, while geographic map coordinates continue to useMapPoint. - Renamed the continuous iOS
mapZoomproperty tomapScaleto align terminology across platforms. - Rebuilt Android libraries with NDK r28.1 and added support for devices using 16 KB memory pages.
Added
- Added public Android surface lifecycle APIs for custom rendering integrations.
- Added
isTapZoomInvertedon iOS for applications that invert double-tap zoom behavior.
See GLMap 1.12.0 for API migration examples.
1.11.0 — 14 January 2025
Added
- Added turn-lane information to route maneuvers, including possible, valid, and active directions for each lane.
- Added route creation from Valhalla JSON responses for server-generated, cached, and hybrid online/offline routing workflows.
- Added alternative-route tracking, including detection when the user passes a junction or continues along another route option.
Changed
- Tap gesture callbacks no longer return a handled flag; pan gesture callbacks retain it for gesture conflict handling.
See GLMap 1.11.0 for the lane-guidance and route-tracking APIs.
1.10.0 — 15 November 2024
Added
- Added map pitch for tilted navigation and perspective map views.
Changed
- Gesture callbacks gained a handled result so applications could coordinate custom pan behavior with built-in map gestures. Tap callbacks were simplified again in 1.11.0.
See GLMap 1.10.0 for the map-pitch introduction.