Allow your users to draw shapes like circles, polygons, and polylines on your map to mark different
areas on the map.
Sample use case: You are developing an app for a delivery company and need to illustrate ranges
of the transportation area around different cities. What you need to do is render circles around
cities with radiuses indicating zones of deliveries. The details on the example implementation of
shapes rendering follows.
The TomtomMap supports several shape overlays which can be easily created by using corresponding
overlay builders. These are:
PolygonBuilder
PolylineBuilder
CircleBuilder
Shape overlays are immutable. That is, once they have been created their shape cannot be changed.
Visibility and color can be changed. If you want to change a shape, you must remove the existing
shape and replace it with a new one. It is the responsibility of the framework user to take care of
performance and the number of shapes in use. You should use as few shapes as possible, and hide or
dispose of the ones that are not being displayed.
