Documentation

Everything you need to build, customize, and share interactive maps with Mapji.

Getting Started

Create your first interactive map in minutes. No coding required.

  1. Sign in — Use your GitHub, Google, or Microsoft account to create a free account.
  2. Create a map — Click Create New Map and enter a name, subdomain, and description.
  3. Choose a map type — Pick from 8 map types: Draw, Cluster, Heatmap, Choropleth, Isochrone, Store Locator, Time Slider, or Story Map.
  4. Import your data — Upload GeoJSON, KML, CSV, or Excel files. Or create data directly on the map.
  5. Configure & customize — Adjust map styles, controls, interactions, and type-specific settings.
  6. Publish & share — Your map is live at yourmap.mapji.com. Optionally connect a custom domain.

Map Types

Mapji offers 8 distinct map types, each designed for a specific visualization need. Choose the right one for your data and audience.

Draw Map

Draw markers, lines, and polygons directly on your map with an intuitive editing interface. Import existing GeoJSON data or create features from scratch. Each feature can have a custom popup with rich content.

Place markers with custom popups
Draw polygons and lines
Import & export GeoJSON
Edit features after creation
Custom popup content per feature
Save and persist all drawings
Real EstateUrban PlanningEducation

Cluster Map

Group dense point markers into clusters that automatically expand on zoom. Handles thousands of points with smooth performance. Supports spiderfy mode to expand overlapping markers and donut chart clusters for categorized data visualization.

Automatic clustering by zoom level
Custom cluster colors (small, medium, large)
Spiderfy mode for overlapping points
Donut chart clusters with categories
Handles thousands of points efficiently
Click clusters to zoom and expand

Settings

Small cluster color< 10 features
Medium cluster color10-49 features
Large cluster color50+ features
SpiderfyToggle on/off
Donut chartsToggle on/off
Category propertyAny data field
LogisticsField ServicesIoT

Heatmap

Visualize data density with smooth heat gradients that reveal geographic patterns at a glance. Adjust intensity, radius, and color gradients to highlight areas of concentration. Supports weight-based rendering for variable point intensity.

Adjustable intensity and radius
Multiple color gradient presets
Weight-based rendering
Custom opacity control
Real-time visualization updates
Smooth density interpolation

Settings

Intensity0.5 - 3.0
Radius2 - 50 pixels
Opacity0 - 1
GradientsblueRed, greenYellow, purpleOrange + more
Crime AnalysisEpidemiologyMarketing

Choropleth Map

Color geographic regions by data values to reveal spatial distributions. Perfect for demographic, economic, and election data. Supports country and region boundaries with customizable color scales and automatic legend generation.

Country & region boundary support
Custom color scales with legends
Data-driven color mapping
Interactive region editing
Automatic bounds calculation
Multiple color scale presets

Settings

Color scalesblues, greens, reds, purples, oranges, grays
Min/Max valuesAuto-calculated or manual
LegendAuto-generated from data
GovernmentResearchJournalism

Isochrone Map

Show travel-time reachability zones from any point. Visualize how far someone can travel in specific time intervals or distances using different modes of transportation. Place up to 5 source points and compare coverage areas.

4 travel modes: walk, bike, car, transit
Time-based zones (5 - 60 minutes)
Distance-based zones (500m - 10km)
Up to 5 source points
Color-coded visualization layers
Overlay on any base map theme

Settings

Travel modesWalking, Biking, Driving, Transit
Time presets5, 10, 15, 30, 45, 60 minutes
Distance presets500m, 1km, 2km, 5km, 10km
Source pointsUp to 5
Real EstateHealthcareSite Selection

Store Locator

Build a searchable location finder with filterable lists, distance calculations, and detail panels. Full-text search across all fields, custom filter categories, and per-filter marker icons. Includes "Near Me" geolocation and customizable display cards.

Full-text search by address or name
Custom filters (select, multiselect, range)
Per-filter custom marker icons
Distance calculations from user location
"Near Me" geolocation feature
Customizable cards with images & hours
Up to 5 extra display fields
Maki or Lucide icon library support

Settings

Filter typesSelect, Multiselect, Range
Display fieldsTitle, subtitle, description, image
Extra fieldsUp to 5 additional
Working hoursConfigurable per location
Marker iconsMaki (standard) or Lucide (React)
RetailHospitalityFranchises

Time Slider Map

Animate data over time with an interactive timeline. Auto-detects temporal fields in your data and lets you scrub through dates to watch patterns emerge. Supports trail visualization to keep previous time periods visible with adjustable opacity.

Auto-detect temporal data fields
ISO, Unix timestamp, and custom formats
Adjustable playback speed
Loop/replay toggle
Trail visualization (show history)
Play/pause animation controls
Customizable panel title

Settings

Time formatsISO 8601, Unix timestamp, custom
Playback speedAdjustable (ms per frame)
LoopToggle on/off
TrailsToggle with opacity 0 - 1
Climate ScienceHistoryEpidemiology

Story Map

Create narrative-driven maps that guide viewers through locations with scroll-based storytelling. Each chapter combines rich markdown content with fly-to map animations. Customize camera positioning, marker icons, and animation effects per chapter.

Scroll-driven navigation (Scrollama)
Rich markdown content per chapter
Fly-to animations between chapters
Custom camera: zoom, bearing, pitch
Per-chapter marker icons and colors
7 animation presets
Progress indicator bar
Full UI customization
Keyboard navigation support

Settings

Camera zoomAny zoom level
Bearing0 - 360 degrees
Pitch0 - 85 degrees
Animation durationDefault 2000ms
Animation presetsfade, slide-up, slide-left, scale-in, blur-in, spring-up
Sidebar width280 - 600px (default 400)
TourismJournalismEducation

Interaction Settings

Control how users interact with your published map. All interactions are enabled by default. Disable interactions to prevent accidental zooming while scrolling, or lock the map entirely for a kiosk-style display. Use the Lock All / Unlock All toggle to quickly switch between interactive and locked modes.

Drag Pan

Click and drag to pan the map

On

Drag Rotate

Right-click and drag to rotate the map

On

Scroll Zoom

Zoom with mouse wheel or trackpad

On

Double-Click Zoom

Zoom in on double-click

On

Touch Zoom & Rotate

Pinch to zoom and rotate on touch devices

On

Box Zoom

Hold Shift and drag to zoom into a specific area

On

Keyboard

Arrow keys and +/- to navigate the map

On

Map Controls

Toggle the UI controls that appear on your published map. Controls marked as "Off" by default can be enabled in the editor toolbar.

Zoom Buttons

Plus and minus zoom controls

On

Compass

North indicator and bearing reset

On

Locate Me

Find user's current location (requires browser permission)

Off

Scale Bar

Distance measurement reference

On

Fullscreen

Toggle fullscreen map view

Off

Minimap

Overview minimap in the corner

Off

Export

Export map as image or PDF

Off

Map Themes & Styles

Choose from 6 base map themes. Switch themes anytime from the editor toolbar — your data and settings are preserved.

Light

Clean, minimal light basemap

Dark

Elegant dark vector basemap

White

High-contrast white background

Black

High-contrast black background

Grayscale

Neutral monochrome rendering

Satellite

ESRI aerial imagery with labels

Advanced Features

All themes support these optional 3D overlays. Toggle them from the style picker in the editor toolbar.

3D Terrain

Real-world elevation data with automatic hillshading for depth perception. Exaggeration adjustable from 1.0 to 3.0.

3D Buildings

Real-world building heights from Overture Maps (2.6 billion buildings). Rendered as 3D fill-extrusions with automatic pitch adjustment.

Contour Lines

Auto-scaling elevation contour intervals that adapt to zoom level. Includes major/minor contour differentiation and elevation labels.

Data Import

Import your data through the editor or create it directly on the map. Mapji supports two main import formats.

GeoJSON Files

Upload standard GeoJSON feature collections with points, lines, and polygons.

.geojson.json.kml

Spreadsheets

Upload tabular data with latitude and longitude columns. Mapji auto-detects coordinate columns and converts your data to GeoJSON. A column mapping modal lets you confirm the detected fields.

.csv.xlsx.xls

Site Settings

Configure your map site from the Settings page in the dashboard. Settings are organized into three tabs.

General

  • Name — Your map title (used as the page meta title for SEO, max 32 characters)
  • Description — Map description (used as the page meta description for SEO)
  • Map Type — Change between the 8 map types (may affect data display)

Appearance

  • Thumbnail — Site preview image (recommended 1200x630px, max 50MB)
  • Logo — Site logo (recommended 400x400px, max 50MB)
  • Font — Choose from available font families
  • 404 Message — Custom message for missing pages (max 240 characters)

Domains

  • Subdomain — Your map lives at yourmap.mapji.com
  • Custom Domain — Connect your own domain (e.g., maps.yourbrand.com) with automatic DNS verification