Atlasemoji quick starts

Quick-Start Integrations

I built Atlasemoji to help people turn geography into something readable, useful, shareable, and easy to work with. Whether you’re building an emergency planning map, a classroom migration lesson, a whale migration overlay, a neighborhood meetup guide, a field inspection route, or a historical journey people can actually read, the same core idea applies: one structured map object can power several useful surfaces. 🌍

This page is meant to be practical. Each vertical below explains what people in that workflow usually need, how Atlasemoji supports it, and a working example you can try in the Developer Workbench, Import tool, or API Explorer. I want this to feel like a friendly field guide, not a pile of abstractions. 🧭

Featured deep dive

Emergency Planning, Incident Command, and Public Readiness

This deeper quick-start goes into evacuation routes, shelters, incident command posts, staging areas, service zones, operational periods, and common operating pictures using Atlasemoji, GeoJSON, manifests, embeds, static maps, and API-friendly examples.

Featured deep dive

Historical Storytelling, Journey Maps, and Routes You Can Read

This deeper quick-start is all about turning journeys into compelling public-facing story maps. It covers narrative waypoints, route structure, manifests, multilingual reading surfaces, embeds, static previews, and API-friendly publishing patterns.

One object, many surfaces

Atlasemoji is manifest-first. That means one published map object can become manifest JSON, GeoJSON, a live embed, a static image, a postcard, and a public API response.

Best first sequence

A great first path is: manifest β†’ GeoJSON β†’ embed β†’ static image. That makes it easy to see one map object move through different surfaces.

Good for learning and shipping

These examples are useful for learning, but they also lead to practical results people can actually use in reports, class projects, websites, briefings, and field workflows.

Great for public-facing work

Some teams need an interactive embed. Others need a clean static map for a handout, article, landing page, or social share card. Atlasemoji supports both.

Emergency planning and incident command

Emergency planning, evacuation routes, and common operating pictures

People searching for evacuation route maps, incident command mapping, shelter maps, operational overlays, and common operating picture tools usually need something more practical than a generic map. They need waypoints, routes, zones, notes, and clear outputs they can reuse.

How Atlasemoji supports this

Atlasemoji supports emergency planning workflows by letting one structured map object represent shelters, coordination points, aid stations, evacuation routes, neighborhood meetup areas, staging zones, and operational overlays. That same object can then become a live embed for a dashboard, a static image for a briefing packet, a GeoJSON file for interchange, and a canonical manifest for internal systems. That makes it useful for emergency planning teams, campus readiness groups, neighborhoods, schools, and civic organizers.

What this usually includes
incident facilitiesevacuation routeshazard polygonsnotes and metadatastatic mapslive embeds
Best output surface

For a planning room or coordination dashboard, the live embed is great. For a handout, briefing packet, share card, or low-bandwidth workflow, the static image surface is a strong fit. πŸ“

Go deeper

This vertical has a dedicated deep-dive page with richer examples, more detailed workflow language, and stronger hands-on guidance.

Quick-start GeoJSON example
{
  "type": "FeatureCollection",
  "properties": {
    "title": "Neighborhood Readiness Map β€” Operational Period 1",
    "incident_id": "AE-DEMO-001",
    "operational_period": "2026-03-16T08:00:00Z/2026-03-17T08:00:00Z",
    "description": "A simple common operating picture for a neighborhood response plan."
  },
  "features": [
    {
      "type": "Feature",
      "properties": {
        "title": "Community Coordination Point",
        "emoji": "πŸ“",
        "ics_facility": "ICP",
        "status": "Active"
      },
      "geometry": {
        "type": "Point",
        "coordinates": [-122.3321, 47.6062]
      }
    },
    {
      "type": "Feature",
      "properties": {
        "title": "Primary Walking Route",
        "emoji": "➑️",
        "stroke": "#2563eb",
        "stroke-width": 4
      },
      "geometry": {
        "type": "LineString",
        "coordinates": [
          [-122.3321, 47.6062],
          [-122.3290, 47.6078],
          [-122.3248, 47.6094]
        ]
      }
    },
    {
      "type": "Feature",
      "properties": {
        "title": "Temporary Water Coverage Area",
        "emoji": "πŸ’§",
        "fill": "rgba(37,99,235,0.20)",
        "stroke": "#2563eb"
      },
      "geometry": {
        "type": "Polygon",
        "coordinates": [[
          [-122.3380, 47.6040],
          [-122.3295, 47.6040],
          [-122.3295, 47.6095],
          [-122.3380, 47.6095],
          [-122.3380, 47.6040]
        ]]
      }
    }
  ]
}
Education and classroom mapping

Interactive history, geography, migration, and curriculum-friendly mapping

Teachers, students, and curriculum designers often search for historical route maps, migration map projects, interactive geography examples, classroom GeoJSON tutorials, and educational map embeds that are easy to understand and easy to present.

How Atlasemoji supports this

Atlasemoji works especially well in classrooms because the same geography can be read as a story, viewed on a live map, exported as GeoJSON, and reused as a polished visual. That makes it useful for migration history, trade routes, science journeys, pilgrimage narratives, environmental lessons, and student-built map assignments. A route can carry titles, chapter notes, waypoint descriptions, and language-specific content, which helps a lesson feel alive instead of flat.

What this usually includes
historical routeswaypoints with notesstudent-readable examplesGeoJSONembeddable lessonsstory surfaces
Best output surface

A live embed is great for classroom discussion. GeoJSON is great for showing students how a route is actually structured. The static surface is perfect for slides, handouts, and LMS posts.

Quick-start classroom route
{
  "type": "Feature",
  "properties": {
    "title": "The Chumak Salt Road",
    "traveler": "Student Research Team",
    "emoji": "πŸ§‚",
    "period": "Early modern era",
    "lesson_focus": "Trade, geography, and movement"
  },
  "geometry": {
    "type": "LineString",
    "coordinates": [
      [30.52, 50.45],
      [32.05, 48.45],
      [30.72, 46.48]
    ]
  }
}
Research, journalism, and analysis

Crisis overlays, regional analysis, and map-driven reporting

Researchers, journalists, policy students, and advocacy teams often need layered maps that explain overlap: drought and access, movement and infrastructure, protected areas and pressure, facilities and service gaps, or routes and surrounding context.

How Atlasemoji supports this

Atlasemoji supports this kind of work by letting several kinds of geography live together inside one FeatureCollection or one manifest. A researcher can combine polygons, points, and routes, then use Atlasemoji to publish a live embed, a static image for a paper or report, and a reusable API response for other tools. This is especially useful when the goal is not just to show a place, but to explain how several conditions relate to one another.

What this usually includes
overlay polygonsservice pointsregional analysisreport-friendly outputsGeoJSON exportpublic embeds
Best output surface

For reports and articles, the static image surface is often the cleanest deliverable. For digital journalism or classroom review, the live embed gives readers more room to inspect the layers.

Quick-start crisis overlay
{
  "type": "FeatureCollection",
  "properties": {
    "title": "Regional Overlay β€” Drought, Access, and Aid",
    "description": "A layered teaching example for research, journalism, and analysis."
  },
  "features": [
    {
      "type": "Feature",
      "properties": {
        "title": "Low Rainfall Area",
        "emoji": "β˜€οΈ",
        "fill": "rgba(234,88,12,0.22)",
        "stroke": "#ea580c"
      },
      "geometry": {
        "type": "Polygon",
        "coordinates": [[
          [34.5, 4.2], [36.2, 4.2], [36.2, 2.5], [34.5, 2.5], [34.5, 4.2]
        ]]
      }
    },
    {
      "type": "Feature",
      "properties": {
        "title": "Transport Access Constraint",
        "emoji": "🧭",
        "fill": "rgba(220,38,38,0.22)",
        "stroke": "#dc2626"
      },
      "geometry": {
        "type": "Polygon",
        "coordinates": [[
          [35.5, 3.5], [37.5, 3.5], [37.5, 1.5], [35.5, 1.5], [35.5, 3.5]
        ]]
      }
    },
    {
      "type": "Feature",
      "properties": {
        "title": "Aid Distribution Point",
        "emoji": "🍞"
      },
      "geometry": {
        "type": "Point",
        "coordinates": [35.1, 2.8]
      }
    }
  ]
}
Maritime, wildlife, and environmental routes

Whale migration maps, sanctuary overlays, marine routes, and conservation storytelling

Marine and environmental teams often need to show movement across water, protected areas, observation points, survey paths, migration corridors, and route relationships that are easy to understand for researchers, students, or the public.

How Atlasemoji supports this

Atlasemoji can represent marine routes, wildlife migration paths, survey stations, observation points, and protection zones using the same manifest-first structure it uses for land-based stories. That means a whale migration route can sit beside a sanctuary polygon and a few observation waypoints, then be published as a live public surface, a static share image, or a GeoJSON output for further analysis. It is a good fit for marine biology, conservation outreach, coastal monitoring, educational storytelling, and public interpretation.

What this usually includes
migration routesmarine sanctuariessurvey waypointsconservation overlaysGeoJSON outputstory-first presentation
Best output surface

This kind of content often works beautifully as both an educational embed and a social share preview. It also makes a strong candidate for place pages and field-guide style storytelling. 🌊

Quick-start marine example
{
  "type": "FeatureCollection",
  "properties": {
    "title": "Whale Road β€” Seasonal Migration",
    "description": "A marine mapping example with route + sanctuary overlay."
  },
  "features": [
    {
      "type": "Feature",
      "properties": {
        "title": "Migration Path",
        "emoji": "πŸ‹",
        "stroke": "#2563eb",
        "stroke-width": 4
      },
      "geometry": {
        "type": "LineString",
        "coordinates": [
          [-157.8583, 21.3069],
          [-145.0000, 32.0000],
          [-125.0000, 48.0000]
        ]
      }
    },
    {
      "type": "Feature",
      "properties": {
        "title": "Protected Marine Zone",
        "emoji": "🌊",
        "fill": "rgba(5,150,105,0.20)",
        "stroke": "#059669"
      },
      "geometry": {
        "type": "Polygon",
        "coordinates": [[
          [-130.0, 45.0],
          [-124.0, 45.0],
          [-124.0, 49.0],
          [-130.0, 49.0],
          [-130.0, 45.0]
        ]]
      }
    }
  ]
}
Campus, family, and neighborhood use

Campus safety maps, family meetup plans, and neighborhood guide layers

Some of the most useful maps are personal and local. People search for family emergency meeting point maps, neighborhood meetup route maps, campus readiness maps, and community guide maps because they want something they can actually keep and use.

How Atlasemoji supports this

Atlasemoji supports family, campus, and neighborhood workflows with map objects that can hold meetup points, clinics, charging stops, walking routes, shelters, backup destinations, and local notes. One object can stay simple enough for a phone screen, polished enough for a printable share, and structured enough for a longer-term neighborhood resource. That makes it useful for families, campus teams, community groups, resident associations, and local organizers.

What this usually includes
meeting pointscampus routeslocal notesprintable outputsmobile-friendly embedshelpful neighborhood guides
Best output surface

For this vertical, a static image often becomes the everyday favorite because it’s easy to save, text, print, and revisit. The live embed is perfect when people want a richer map view.

Quick-start family muster map
{
  "type": "FeatureCollection",
  "properties": {
    "title": "Family Muster Map",
    "description": "A useful neighborhood map for meetup spots and fallback points."
  },
  "features": [
    {
      "type": "Feature",
      "properties": {
        "title": "Home",
        "emoji": "🏠"
      },
      "geometry": {
        "type": "Point",
        "coordinates": [-122.3321, 47.6062]
      }
    },
    {
      "type": "Feature",
      "properties": {
        "title": "School Meetup",
        "emoji": "πŸŽ’"
      },
      "geometry": {
        "type": "Point",
        "coordinates": [-122.3278, 47.6098]
      }
    },
    {
      "type": "Feature",
      "properties": {
        "title": "Backup Park Meetup",
        "emoji": "🌳"
      },
      "geometry": {
        "type": "Point",
        "coordinates": [-122.3230, 47.6115]
      }
    }
  ]
}
Field operations and site work

Field survey routes, inspection points, checkpoints, and site walkthroughs

Teams doing surveys, inspections, site visits, maritime checks, environmental observation, facilities work, or local documentation often need to collect waypoints and routes with notes, then turn that work into something reusable.

How Atlasemoji supports this

Atlasemoji supports field operations by giving teams a clean path from collected geography to map-ready output. Waypoints can represent checkpoints, stations, asset locations, observations, or task stops. Routes can represent a walk path, survey line, inspection sequence, or movement corridor. Once normalized, the same object can be reviewed in Atlasemoji, exported as GeoJSON, embedded in internal docs, or published for broader use.

What this usually includes
inspection pointssite walk routesfield notesasset locationssurvey-friendly geographymanifest publishing
Best output surface

GeoJSON and manifest JSON are excellent for system-to-system work. The embed surface is especially good when the route needs to be reviewed by a manager, client, or partner.

Quick-start field inspection map
{
  "type": "FeatureCollection",
  "properties": {
    "title": "Site Walk β€” Inspection Route",
    "description": "A practical field operations example with checkpoints and notes."
  },
  "features": [
    {
      "type": "Feature",
      "properties": {
        "title": "Start Gate",
        "emoji": "πŸšͺ",
        "note": "Meet vendor here at 08:00"
      },
      "geometry": {
        "type": "Point",
        "coordinates": [-122.3321, 47.6062]
      }
    },
    {
      "type": "Feature",
      "properties": {
        "title": "Inspection Path",
        "emoji": "πŸ› οΈ",
        "stroke": "#7c3aed",
        "stroke-width": 4
      },
      "geometry": {
        "type": "LineString",
        "coordinates": [
          [-122.3321, 47.6062],
          [-122.3338, 47.6074],
          [-122.3356, 47.6087]
        ]
      }
    }
  ]
}
Historical storytelling and public history

Routes you can read: historical journeys, trade roads, pilgrimage paths, and cultural travel

This is one of the places where Atlasemoji really shines. Public history, museums, teachers, story editors, and independent researchers often want a route that doesn’t just draw movement β€” it tells people what happened, where, and why it matters.

How Atlasemoji supports this

Atlasemoji is built for narrative geography. A historical route can be published as a curated story, but it can also be fetched as a manifest, rendered as GeoJSON, shared as a static preview, or embedded live into a page. Waypoints can hold titles, notes, tags, emoji, descriptive copy, and translated variants. That makes Atlasemoji a strong fit for migration stories, caravan routes, maritime journeys, cultural travel, biographies in motion, and public-facing map storytelling.

What this usually includes
narrative waypointscurated routestranslation-ready structurestory embedsshare previewspublic reading surfaces
Best output surface

The live story embed is usually the strongest public-facing surface here, while the static image is great for social, outreach, and presentation support.

Go deeper

This vertical has a dedicated deep-dive page with richer examples, more detailed workflow language, and stronger hands-on guidance.

Quick-start API sequence
curl -s "/api/manifests/story-geronimo?lang=en&pretty=1"

curl -s "/api/manifests/story-geronimo?format=geojson&pretty=1"

curl -s "/api/embed/story-geronimo/static?lang=en&width=1200&height=630"

Open the live surface:
  /embed/story-geronimo?lang=en&mode=story&panel=1&height=720
Developers and platform teams

Manifest-first integrations for apps, docs, websites, and internal tools

Developers searching for a map API, GeoJSON manifest workflow, static preview endpoint, embed surface, or OpenAPI-based mapping contract usually want one thing: a clean, understandable system that works across several outputs.

How Atlasemoji supports this

Atlasemoji is manifest-first. That means one canonical object can power several useful surfaces without making a team rebuild the same map data again and again. Developers can fetch the manifest JSON, compare it to GeoJSON, open the live embed, generate a static preview image, or build around the same object in internal or public tools. This is useful for developer docs, storytelling products, location-aware apps, education platforms, editorial workflows, and partner integrations.

What this usually includes
manifest JSONGeoJSONembed surfacestatic previewOpenAPI workflowcopyable request paths
Best output surface

The best first habit is still the same: manifest β†’ GeoJSON β†’ embed β†’ static image. Once that clicks, the API starts to feel very natural.

Quick-start developer pattern
// One Atlasemoji object, several useful surfaces

const manifestId = "story-geronimo";
const lang = "en";

// 1) Canonical manifest JSON
fetch(`/api/manifests/${manifestId}?lang=${lang}&pretty=1`);

// 2) GeoJSON output
fetch(`/api/manifests/${manifestId}?lang=${lang}&format=geojson&pretty=1`);

// 3) Live embed page
const embedUrl = `/embed/${manifestId}?lang=${lang}&mode=story&panel=1&height=720`;

// 4) Static preview surface
const staticUrl = `/api/embed/${manifestId}/static?lang=${lang}&width=1200&height=630`;
Atlasemoji vocabulary decoder

From human maps to machine maps

If you’re thinking about…Atlasemoji calls it…The API calls it…Why it matters
The overall story or map objectA map objectManifestThis is the canonical publishing object that can generate several useful surfaces.
A meaningful locationWaypointFeature / itemThis is where titles, notes, emojis, and location-aware metadata often begin.
The raw shapePoint / route / areaGeometryThis is the part that tells the map where to draw.
The extra informationStory tags / metadataPropertiesThis is where the object becomes useful, readable, and specific.
The live public mapEmbedLive surfaceGreat for sites, docs, demos, dashboards, and public sharing.
The share imageStatic map / postcardStatic image surfaceGreat for reports, handouts, social cards, and lightweight distribution.
A practical next step

Pick one section above that matches your world, then run the same object through the Developer Workbench. Start with the manifest, compare the GeoJSON, open the embed, and then generate a static image. That simple sequence teaches a lot very quickly while still producing something useful.