Skip to main content

IOCheese Maps API Overview

The IOCheese Maps API delivers high-performance vector map tiles, customizable styles, and modern geospatial APIs for web and mobile applications.

Providing OpenStreetMap-based vector map data and built on open standards (compatible Style JSON specification and Mapbox Vector Tile .pbf format), IOCheese Maps enables developers to render smooth, interactive, and responsive maps with minimal setup.

What IOCheese Maps Provides​

  • Fast Vector Tile Streaming: Compressed, lightweight vector tiles (.pbf) delivering crisp rendering across all zoom levels.
  • Multiple Map Themes: Out-of-the-box support for visual themes:
    • Standard — Full-color daytime vector map for general navigation and asset tracking.
    • Dark — High-contrast dark mode optimized for night operations and control rooms.
    • Sketch — Minimalist monochrome styling highlighting road networks and boundaries.
    • High Resolution — High-DPI rendering for retina and 4K displays.
  • Developer-Friendly Authentication:
    • Map Access Key: Pass ?key=YOUR_KEY directly in frontend URLs.
    • OAuth 2.0 Client Credentials: Server-to-server 1-hour JWT bearer tokens for secure backend integration.
  • Broad Client Compatibility: Compatible with MapLibre GL JS, Mapbox GL, OpenLayers, Leaflet, and mobile vector rendering libraries.

How It Works​

flowchart LR
    subgraph ClientApp ["Your Application"]
        Browser["Web / Mobile Map Client"]
    end

    subgraph Auth ["Authentication"]
        Key["Map Access Key (?key=...)"]
        OAuth["OAuth 2.0 Bearer Token"]
    end

    subgraph IOCheeseMaps ["IOCheese Maps API"]
        StyleEP["GET /v1/map/styles/{style}/style.json"]
        TileEP["GET /v1/map/tiles/{z}/{x}/{y}.pbf"]
    end

    Browser -->|Request Style| StyleEP
    Browser -->|Request Tiles| TileEP
    Key -.-> StyleEP
    Key -.-> TileEP
    OAuth -.-> StyleEP
    OAuth -.-> TileEP
  1. Configure in Console: Create and manage your Map Profile in the IOCheese Web Console to obtain your Map Access Key or OAuth Client Credentials.
  2. Load Style: Your map client requests style.json passing your credentials.
  3. Render Tiles: The map client automatically requests and renders vector tiles as users pan and zoom.

Next Steps​