Troubleshooting
Identify authentication, request, map rendering and data problems from the symptom you see.
Start with the HTTP status or browser console message, then isolate the smallest failing request.
401 or 403
Check that the key reaches X-MapScale-Key. For browser maps, verify the publishable key and exact allowed origin. Confirm that the key permits the requested product.
Blank or partially rendered map
Open browser developer tools and inspect style, tile, glyph and sprite requests. Confirm the map container has a non-zero height and MapLibre CSS is loaded.
Unexpected search or route result
Confirm coordinate order, language, bbox and proximity. Reduce the request to required parameters, then add optional filters one at a time.