Mappls SDK – Error Handling Guide¶
title: Mappls Sdk Error Codes
This document describes how the Mappls SDKs handle errors internally. The following error codes and messages will help developers debug integration issues more effectively.
Core SDK Errors¶
| Condition | Exception/Error Message |
|---|---|
.a.olf file is missing in the project |
No .a.olf file found. The Mappls Services Plugin cannot function without it. |
.conf config file is missing from bundle |
.conf file not found in bundle |
.olf file is invalid or corrupted |
Please add a valid .olf configuration file. |
Package name or app fingerprint mismatch in .olf file |
You are using Invalid Configuration. Please check your Package Name / App Fingerprint & download it from the developer console again. |
.conf config file is invalid |
Please add a valid .conf configuration file. |
| Static key is missing (improper setup or missing plugin) | Error Code: 1 |
Error Message: Static Key Not Found |
|
| No HTTP status code associated | |
| Invalid payload during JSON creation | Error Code: 2 |
Error Message: Invalid Payload |
|
| No HTTP status code associated | |
Missing config data, appId, or payloadPubKey |
Error Code: 3 |
Error Message: Invalid Config |
|
| No HTTP status code associated | |
| Payload encryption failure | Error Code: 3 |
Error Message: Invalid Payload |
|
| No HTTP status code associated | |
| Auth1 Token missing or expired (during API call) and config download fails | Error Code: 5 |
Error Message: Authentication Failed |
|
| No HTTP status code associated | |
| Auth1 authentication attempted but access token missing from config | Error Code: 6 |
Error Message: This authentication is not supported |
|
| No HTTP status code associated | |
| Method not provisioned | Error Code: 4 |
Error Message: Method not Provisioned |
|
| No HTTP status code associated |
Map SDK Errors¶
| Condition | Exception/Error Message |
|---|---|
| Config is not read properly by Map SDK (improper setup) | Error Code: 7 |
Error Message: Map Config not available |
|
vectorMap object or style base URL missing in config |
Error Code: 7 |
Error Message: Map Info is not available |
|
Public key or its expiry missing from vectorMap object in config |
Error Code: 8 |
Error Message: Public Key not found |
Note¶
- All errors listed are internal SDK exceptions.
- These do not return standard HTTP status codes.
- Ensure your
.olfand.conffiles are correctly configured and downloaded from the Mappls Developer Console. - Always apply the necessary Mappls plugins and dependencies to your Android project.