v2 upgrade guide
Contents
The latest version of the JavaScript Maps SDK uses vector map tiles, which provide a wide range of additional features and benefits compared with our traditional JavaScript maps (formerly ALK Maps), which use raster tiles. In almost all cases, we recommend new Trimble Maps customers take advantage of the vector tile offering. This guide is meant to help existing raster customers understand how to upgrade to vector maps, as an upgrade requires client-side changes.
Whichever option you choose, we will continue to update all of our maps with the latest data designed specifically for commercial vehicles.
Upgrade steps
1. Test your browser
If you haven’t already, please use our test page to check that the browser you are using is compatible with vector maps. Most modern browsers are able to render vector graphics but older browsers, or browsers built for specific hardware, may not.
2. Consider features and requirements
While both our raster and vector maps platforms support map rendering, routing, geocoding and many other features, they operate very differently. As a result some features may not be directly applicable in vector as they are in raster. We recommend:
- Create a checklist of the features you are currently using with raster maps.
- Compare how those features work in vector maps versus your current raster implementation. Our guides and examples cover the many of the most common use cases. If you don’t find what you are looking for please don’t hesitate to contact our support team. They are more than happy to help you. The table below may help get you started.
| Use Case | Examples |
|---|---|
| Map Initialization | Raster/Vector |
| Context Menu | Raster/Vector |
| Change Map Style | Raster/Vector |
| Cluster | Raster/Vector |
| Custom Panel | Raster/Vector |
| EU Toll Detail Report | Raster/Vector |
| Feature Popup | Raster/Vector |
| Feature Visibility | Raster/Vector |
| Geocoding Results | Raster/Vector |
| Layer Visibility | Raster/Vector |
| POI Layer | Raster/Vector |
| Road Surface Layer | Raster/Vector |
| Route Report | Raster/Vector |
3. Consider your current software architecture
Does your existing application with raster maps make direct calls to Trimble Maps objects and functions throughout the code? If so, you may first want to consider creating your own mapping interface to provide a degree of separation between the map library and the rest of the application. That way, when switching from raster to vector, you will only have to update that mapping interface, not the entire application.
For raster users who already have this map abstraction in place, the switch to vector maps is more straight-forward.