Jagomap Documentation

Quick Start

Get your first map live in under 5 minutes. Here's how it works from start to finish.

Signing In

You don't need to create a new account or remember a separate password. Jagomap lets you sign in using an account you already have — just click Sign In and choose Google or GitHub.

Your Jagomap account is created automatically the first time you sign in. Your name and profile picture are pulled from whichever account you used.

Sign-in Options

How Long Does My Session Last?

You will be logged out automatically after 3 hours of inactivity. You can also sign out manually at any time from the menu in the top-right corner.

Projects

Think of a Project as a folder on your computer. It keeps your maps organized in one place. For example, you might have a project called "Surabaya Field Survey 2024" and another called "Client B — Road Data".

Creating a Project

1. From the dashboard, click New Project.
2. Enter a name and an optional description, then click Create.
3. Your new project opens automatically and is ready for maps.

Switching Between Projects

At the top of the left sidebar you'll see a Project Switcher — click it to jump between your projects. The maps shown in the list will change based on whichever project is active.

Editing and Deleting

• To rename or update a project, click the Edit button on the project page.
• To remove a project, click Delete — but be careful, this will also delete all maps and uploaded files inside it permanently.

Maps

A Map is an interactive web map that lives inside a project. You can upload multiple data layers onto one map — similar to how you stack layers in QGIS or ArcGIS. Anyone you share it with can zoom, pan, and click features to read the data.

Creating a Map

1. Open your project, then click New Map.
2. Enter a title (required) and an optional description.
3. Click Create — your empty map is ready. Now upload a layer to add data to it.

Public vs. Private

Every new map starts as Private — only you can see it. When you're ready to share:

• Open the map → click Edit → switch visibility to Public → Save.
• A Share button will appear — click it to copy the public link.
• Anyone with that link can view the map without needing an account.

Editing and Deleting

• To update the title, description, or visibility, click Edit on the map page.
• To remove a map, click Delete from the maps list — this also permanently removes all uploaded layers inside it.

Layers

A Layer is your uploaded map file displayed on top of the map — just like a layer in QGIS or ArcGIS. Each map can have multiple layers stacked on top of each other, and you can control the order, color, and visibility of each one.

How to Upload a Layer

1. Open a map, then click Upload Layer in the top toolbar.
2. Give the layer a name (e.g. "Flood Zones" or "Road Network").
3. Drag your file into the upload area, or click to browse for it. Accepted formats: .geojson or .json, up to 100 MB.
4. Click Upload Layer — your data will appear on the map within seconds.

Managing Your Layers

• To see all layers across all your maps, click Layers in the left sidebar.
• You can rename, recolor, reorder, or delete any layer from the Layer Manager inside the map.
• To delete a layer, click the trash icon — this cannot be undone.

Export Guide

Jagomap requires your map data in GeoJSON format. The good news: every major GIS application can export to this format. Find your tool below and follow the steps.

From QGIS

QGIS is the easiest tool to export GeoJSON from. Follow these steps:

1. In the Layers panel on the left, right-click the layer you want to export.
2. Select Export → Save Features As…
3. In the Format dropdown, choose GeoJSON.
4. Under CRS, make sure it says EPSG:4326 – WGS 84. If not, click the icon next to it and search for "4326".
5. Choose where to save the file, then click OK.
6. Your .geojson file is ready to upload to Jagomap.

From ArcGIS Pro

ArcGIS Pro does not have a direct "Export as GeoJSON" button. You need to use the Features To JSON geoprocessing tool:

1. Go to the Analysis tab in the top ribbon, then click Tools.
2. In the search box, type Features To JSON and click the result.
3. Set Input Features to your layer.
4. Set Output JSON to your desired file path — name it with a .geojson extension (e.g. flood_zones.geojson).
5. Check the box labeled Output to GeoJSON.
6. Click Run. Your file is saved to the location you specified.

From ArcGIS Online

You can export a hosted feature layer directly from the ArcGIS Online website:

1. Go to your Content page in ArcGIS Online.
2. Find the feature layer you want to export and click on its title to open it.
3. Click the Export To button (or the three-dot menu → Export).
4. Choose GeoJSON from the format list.
5. Give the export a name and click Export. The file will appear in your Content when ready.
6. Click Download to save it to your computer, then upload it to Jagomap.

From Google Earth Pro

Google Earth Pro cannot export directly to GeoJSON — it only saves to KML format. You need to save as KML first, then convert using QGIS. Here's the full process:

Step 1 — Save from Google Earth Pro:

1. In the Places panel, right-click the folder or placemark you want to export.
2. Select Save Place As…
3. In the format dropdown at the bottom, choose KML (not KMZ).
4. Save the file to your computer.

Step 2 — Convert to GeoJSON in QGIS:

1. Open QGIS and drag your .kml file into the map canvas.
2. In the Layers panel, right-click the KML layer.
3. Select Export → Save Features As…
4. Set Format to GeoJSON and CRS to EPSG:4326 – WGS 84.
5. Click OK. Your GeoJSON file is ready to upload.

Other Tools

geojson.io (quickest for small datasets)

1. Go to geojson.io in your browser.
2. Draw your features directly on the map, or paste existing data into the editor on the right.
3. Click Save → GeoJSON. The file downloads automatically.

GeoPandas (Python)

If your data is in a GeoDataFrame, export it with:

# Make sure coordinates are in WGS 84 first
gdf = gdf.to_crs("EPSG:4326")

# Export to GeoJSON
gdf.to_file("output.geojson", driver="GeoJSON")

Any other GIS tool

Look for an Export or Save As option and choose GeoJSON as the format. If it's not available, import the file into QGIS first and then export from there.

What Is a GeoJSON File?

GeoJSON is an open file format for storing map data — think of it as a smarter version of a Shapefile that works natively on the web. It stores your geographic shapes (points, lines, polygons) together with their attribute data (names, values, categories) in a single file.

If you use QGIS, ArcGIS, or Google Earth Pro, you already have the tools to export GeoJSON. You don't need to understand the file format itself — just export it from your software and upload it to Jagomap.

A Note on Coordinates

GeoJSON always stores coordinates as longitude first, then latitude — the reverse of how you might say it out loud ("latitude, longitude"). This is handled automatically when you export from QGIS or ArcGIS, so you don't need to worry about it unless you are building the file by hand.

"coordinates": [106.82, -6.17]
// [longitude, latitude]

"coordinates": [-6.17, 106.82]
// [latitude, longitude] ← wrong!

Geometry Types

Jagomap supports all standard GeoJSON geometry types as defined in RFC 7946.

Polygon Example (with hole)

{
  "type": "Feature",
  "geometry": {
    "type": "Polygon",
    "coordinates": [
      [[106.82, -6.18], [106.85, -6.18], [106.85, -6.15], [106.82, -6.15], [106.82, -6.18]],
      [[106.83, -6.17], [106.84, -6.17], [106.84, -6.16], [106.83, -6.16], [106.83, -6.17]]
    ]
  },
  "properties": { "name": "Zone A" }
}

The first array is the outer ring. Additional arrays define holes (interior rings) that are excluded from the polygon area.

Attribute Data (Properties)

Every feature on your map can carry attribute data — just like the attribute table in QGIS or ArcGIS. When someone clicks a feature on the map, a popup appears showing all that feature's data.

This data comes directly from the attribute table of your original layer. Whatever columns you had in QGIS or ArcGIS will appear in the popup — field names as labels, values as the content.

Tips for Clean Popups

• Use clear, descriptive field names in your GIS software before exporting — these become the labels in the popup (e.g. road_name is clearer than rn).
• Make sure all features in a layer use the same field names — inconsistent fields can cause some popups to show blank values.
• Empty or null values will simply not appear in the popup.

File Requirements

Before uploading, make sure your file meets these requirements. Most GIS exports will already satisfy them automatically.

Layer Manager

Access the Layer Manager from the map editor via the Layer Manager button in the header. It opens a full management table for all layers in the map.

Rename

Click the pencil icon next to any layer row to open the Rename modal. Type the new name and press Save (or Enter). The name is updated immediately in the database.

Change Color

Click the color swatch button on any layer row to open the Color picker. Choose one of 12 preset colors — the layer color is saved to the database and will be used consistently across the map editor and public map view.

Download

Click the download icon to download the original GeoJSON file exactly as it was uploaded. The file is saved as <layer-name>.geojson.

Reorder (Drag & Drop)

When a map has more than one layer, a Layer Order section appears above the table. Drag the rows by the grip handle on the left to change the z-index order. The topmost row in the list renders on top of the map.

• Reordering is saved immediately — no page reload needed.
• The order is reflected the next time the map editor or public map loads.
• Numbers on the right (#1, #2…) show the current render priority.

Delete

Click the trash icon to delete a layer. A confirmation dialog appears. Deletion permanently removes the layer and its GeoJSON file from storage.

Map Editor

The map editor is accessible at /maps/{id} after logging in. It shows the map with all uploaded layers and a right-side panel.

Header Actions

• Share — copies the public URL to clipboard. Only shown if the map is public.
• Upload Layer — opens a modal to upload a new GeoJSON file (max 100 MB).
• Layer Manager — navigates to the full layer management page.
• Edit — opens a flyout to edit map title, description, and visibility.

Layers Tab

The right panel defaults to the Layers tab. Each row shows the layer color dot, name, and feature count.

• Click a row — zooms the map to fit that layer's bounds.
• Eye icon — toggles layer visibility on/off.
• Download icon — downloads the GeoJSON file.
• Trash icon — opens delete confirmation (owners/editors only).

Data Tab

The Data tab shows a searchable list of all features across all loaded layers. Type any value to filter across all properties. Click a result to zoom the map to that feature.

Basemap Switcher

At the bottom of the Layers tab, choose from 10 basemap styles:

• Topo, Street, NatGeo, Satellite — Esri tile services
• Positron, Dark, Voyager — CARTO styles (clean, minimal)
• OSM, Humanitarian, OpenTopo — OpenStreetMap variants

Cluster

Layers containing Point or MultiPoint features are automatically clustered when zoomed out using Leaflet MarkerCluster. Clusters expand as you zoom in. Polygon and line layers are not clustered.

Popup

Click any feature on the map to open a popup showing all its GeoJSON properties. The popup header displays the layer name with a color indicator.

Public Map

Public maps are accessible without authentication at /map/{slug}. The URL is shareable — anyone with the link can view the map.

Making a Map Public

Open the map editor → click Edit → toggle the visibility to Public and save. A Public badge appears in the header and a Share button becomes available to copy the public URL.

Panel

The public map has a collapsible right panel with two tabs:

• Data tab (default) — search features by any property value. Click a result to zoom to it.
• Layers tab — toggle layer visibility, click a layer to zoom, and switch the basemap.

On mobile the panel is hidden by default. Tap the floating Layers button to open it.

Basemap

The same 10 basemap options available in the editor are also available in the public view, under the Layers tab.

Explore All Maps

Visit /map to browse all public maps on the platform. Use the search bar to find maps by title.