API Reference
The SDK exposes the same class model on every platform — the C++ core is wrapped by SWIG into native Java, Objective-C/Swift and C# bindings, so classes and methods map 1:1 with a per-platform naming convention.
This page documents the object API — the classes an app constructs and wires by hand. New
work targets the surface API instead: ids, JSON specs and dotted paths, the same
in every language, with its own generated reference. Both are supported,
and adopt moves an app from one to the other a
piece at a time.
Generated reference
| Platform | Reference | Naming |
|---|---|---|
| Android (Java/Kotlin) | Javadoc → | package com.massifmaps.*, e.g. com.massifmaps.ui.MapView |
| iOS (Objective-C/Swift) | Jazzy → | MSF prefix, e.g. MSFMapView |
The per-language reference is generated by CI on every release and published alongside this site. If the links above 404, the docs build has not published API output yet — see building the docs.
Naming conventions
| Concept | Android | iOS |
|---|---|---|
| Class | com.massifmaps.ui.MapView | MSFMapView |
| Enum value | CartoBaseMapStyle.MASSIF_BASEMAP_STYLE_VOYAGER | .MASSIF_BASEMAP_STYLE_VOYAGER |
| Getter | getZoom() / property zoom | getZoom() |
| Vector container | MapPosVector | MSFMapPosVector |
Key packages
| Package | What's in it |
|---|---|
com.massifmaps.core | MapPos, MapBounds, MapVec, vectors, Variant. |
com.massifmaps.ui | MapView and click/gesture listeners. |
com.massifmaps.layers | *TileLayer, VectorLayer, HillshadeRasterTileLayer, CompositeVectorTileLayer, CustomRasterTileLayer. |
com.massifmaps.datasources | HTTPTileDataSource, MBTilesTileDataSource, PMTilesTileDataSource, ContourTileDataSource, caches. |
com.massifmaps.components | Options, TerrainOptions, Layers. |
com.massifmaps.styles / com.massifmaps.vectortiles | CartoCSS styling and vector-tile decoders. |
com.massifmaps.geometry / com.massifmaps.vectorelements | Geometry and on-map elements (markers, lines, polygons, popups). |
com.massifmaps.routing / com.massifmaps.geocoding | Valhalla/SGRE routing and (reverse) geocoding. |
Fork-specific classes
These do not exist in the original CARTO 4.x API — see the Features section for guides:
com.massifmaps.components.TerrainOptions— 3D terrain.com.massifmaps.datasources.ContourTileDataSource— on-the-fly contours.com.massifmaps.layers.CompositeVectorTileLayer— composite layers.com.massifmaps.layers.CustomRasterTileLayer— custom raster shaders.com.massifmaps.datasources.PMTilesTileDataSource— PMTiles.- Extended
com.massifmaps.layers.HillshadeRasterTileLayer— hillshade.