General Mapotic API Tutorial
API Swagger documentation
Authorization
To work with the map via API, you must log in with either the map administrator account or one of the emails assigned as a co-administrator (valid for the PRO plan and above).
When the user logs in, it sends an API token that can be used to access all endpoints in the project. User authorization is then done by adding the http header Authorization: token <token>.
Map endpoints
Map detail | https://www.mapotic.com/api/v1/maps/map_ID/ |
Places list (geojson) | https://www.mapotic.com/api/v1/maps/map_ID/pois.geojson/ |
Place detail | https://www.mapotic.com/api/v1/maps/map_ID/public-pois/<poi_id>/ |
Categories | https://www.mapotic.com/api/v1/maps/map_ID/public-categories/ |
Attributes | https://www.mapotic.com/api/v1/maps/map_ID/attributes_for_filtering/ https://www.mapotic.com/api/v1/maps/map_ID/attributes/ |
Sections | https://www.mapotic.com/api/v1/maps/map_ID/section/ |
Images | https://www.mapotic.com/api/v1/maps/map_ID/pois/POI_ID/images/ |
Parameters that can be used to filter individual endpoints can be found at this link: https://mapotic.github.io/mapotic.com-api-docs/
Filtering
Filtering is done using parameters when using an endpoint for a list of locations https://www.mapotic.com/api/v1/maps/2941/attributes_for_filtering/
Parameter name | Values of the parameters |
extra_fields | owner, created, address |
image | SIZExSIZE (ex. 240×240) |
attrID (ex. attr14823) | The value obtained from the endpoint for attributes (value key), used for filtering. |
Example:
https://www.mapotic.com/api/v1/maps/8251/pois.geojson/?attr14823=Ubytovani,Restaurace&attr14888=Priroda&image=360x360&extra_fields=owner,created
Table of Contents
You might be also interested
Map settings you shouldn’t miss
When creating a new custom map, default settings will already be applied. In order to get the most from Mapotic, you may want to edit them to fit your goals.
How to import multiple places into your Mapotic map
Mapotic’s import tool allows you to batch import thousands of places into your map at once. Whether you’re trying to migrate your map from a
Setting up categories and attributes
Categories and attributes play a very important role in your new interactive map on Mapotic.com. The right combination of these two elements will make your map much easier to use for your new and existing visitors.