Skip to main content

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 GLSearchRequest as 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 37 compatibility 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 GLMapStyleParser methods are throwing.
  • Fly-to animations now use flyToMode and 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 GLMapTrackArrow for drawing directional arrows along navigation routes and other tracks.
  • Added GLMapUserLocation to 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 use MapPoint.
  • Renamed the continuous iOS mapZoom property to mapScale to 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 isTapZoomInverted on 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.