Skip to main content

GeoAI Agent

GeoAI is an AI-powered assistant built into AugmentCity. It understands your current map state — layers, scenario, camera position, and date — and can navigate the globe, find and add geodata, analyze your layers, and answer questions about your project, all through a conversational chat interface.

info

GeoAI is currently in beta. Responses are generated by a large language model and may occasionally be inaccurate. Always review added layers and analysis results before using them in planning decisions.

Opening GeoAI

Click the GeoAI button (bot icon) in the left toolbar. The chat panel opens on the right side of the screen at 480 px wide, overlaying the map.

Click the button again to close the panel.

Panel layout

The GeoAI panel has four main areas:

AreaDescription
HeaderPanel title with a "beta" badge, a wrench icon to show or hide tool call details, and a trash icon to clear the conversation
Message listScrollable history of your conversation with GeoAI
Approval cardsAppear when GeoAI wants to add a layer — you must confirm before it is added
Quota barShows your organisation's daily token usage (green → yellow → red)
Chat inputAuto-expanding text area; press Enter to send, Shift+Enter for a new line; a Stop button appears while GeoAI is responding

Context awareness

GeoAI always knows your current map state. Before it responds, it reads:

  • Camera position — where the globe is currently pointed and at what altitude
  • Scene mode — whether you are in 3D, 2D, or Columbus view
  • Loaded layers — the name, type, and visibility of every layer in your project
  • Active scenario — the name of the scenario you are currently working in
  • Map date — the current date set on the timeline

You do not need to describe your map setup — GeoAI already has this context.

What GeoAI can do

Navigate the map

Ask GeoAI to fly the camera to any location by name or coordinates:

"Fly to Oslo" "Show me the port of Rotterdam" "Go to latitude 59.9, longitude 10.7"

GeoAI animates the camera smoothly to the requested position.

Switch views

Ask GeoAI to change the scene mode:

"Switch to 2D mode" "Show Columbus view" "Go back to 3D"

Control the timeline

Ask GeoAI to move the map date:

"Set the date to January 2024" "Show me the map in summer" "Go back to today"

Toggle layers

Ask GeoAI to change layer visibility:

"Hide the population layer" "Show all layers" "Turn off everything except the flood risk layer"

tip

If you need to quickly toggle several layers, use the Layers panel in the left toolbar — it gives you one-click visibility controls for every layer without consuming your daily AI quota.

Find and add geodata

GeoAI can search multiple geodata sources and add the results directly to your project as new layers. See Adding layers with GeoAI for the full workflow.

Sources GeoAI can search:

  • Norwegian national geodata (Geonorge)
  • Norwegian noise maps (Geonorge + Miljødirektoratet)
  • OpenStreetMap
  • NVE hazard data (floods, avalanches, landslides)
  • Eurostat GISCO (EU administrative boundaries)
  • USGS earthquakes
  • NASA GIBS satellite imagery
  • EMODnet ocean data
  • Copernicus satellite imagery
  • ArcGIS Hub and ArcGIS REST services
  • General web search for geodata

Layer types GeoAI can add:

  • WMS layers
  • WMTS tile layers
  • XYZ tile layers
  • GeoJSON layers
  • Cloud-Optimised GeoTIFF (COG) raster layers
  • ArcGIS Feature Server and Map Server layers
  • Cesium Ion 3D tilesets
  • KML/KMZ layers

Try asking:

"Find flood hazard data for the Oslo region" "Add OpenStreetMap buildings for Rotterdam" "Add a Kartverket WMTS basemap" "Add OpenStreetMap tiles as a background layer" "Find noise maps for Oslo" "Show me road noise data for Bergen" "Add noise contour data for this area"

When you ask for noise data, GeoAI performs a targeted search across Norwegian environmental data sources. It always includes the Miljødirektoratet støy WMS as a primary source and supplements it with relevant datasets from the Geonorge catalog using Norwegian noise terminology (støy, støysonekart, vegstøy, jernbanestøy, and so on).

You can request noise data by source type:

Source typeExample prompt
Road traffic"Find road noise data for Bergen"
Railway"Show railway noise contours along the Oslo–Bergen line"
Aviation"Add air traffic noise maps for the area around Gardermoen"
Industry"Find industrial noise data for this port area"
All sources combined"Show all noise data for Stavanger"

GeoAI understands the standard Norwegian and EU noise metrics:

  • Lden — 24-hour average weighted for evening and night sensitivity (the primary planning metric)
  • Lnight — night-time average (22:00–07:00)
  • Støysone — noise zones (red zone = highest exposure, yellow zone = moderate exposure)

After adding a noise WMS layer, you can ask GeoAI to style it using the standard EU/Norwegian dB color ramp — from green (≤45 dB, low impact) through yellow (55–60 dB), orange (60–65 dB), and red (65–70 dB), up to dark red and purple (≥70–75 dB, high impact):

"Apply standard noise coloring to this layer" "Style the noise layer with the EU dB color ramp"

warning

When GeoAI wants to add a layer, an approval card appears in the chat panel. The layer is not added until you click Add. After it is added, an Undo banner appears so you can remove it in one click if it is not what you wanted.

Run spatial analysis

GeoAI can trigger spatial analysis tools and return results inline in the chat.

AnalysisExample prompt
Viewshed"Run a viewshed from the tower at 59.9, 10.7 with a 2 km radius"
Shadow accumulation"Show shadow hours for this block in June"
Isochrone"Show how far you can walk in 10 minutes from the city hall"
Flood simulation"Simulate 2 metres of flooding around this low-lying area"
Proximity count"How many schools are within 500 m of this development site?"
Temporal change detection"Detect land cover changes in this area between 2022 and 2024"

For viewshed, shadow, isochrone, and flood analysis, GeoAI activates the corresponding tool in the Geoprocessing panel and places the observer or origin point based on the current camera position or a location you specify. You can also run these tools manually — see Geoprocessing Panel for details.

Manage scenarios and layers

GeoAI can create and switch scenarios, style layers, rename layers, and adjust opacity:

"Create a new scenario called 'Year 2030'" "Switch to the baseline scenario" "Make the flood risk layer 50% transparent" "Style the buildings layer using a gradient based on height"

Place parametric buildings

GeoAI can create a 3D parametric building directly on the map from a text prompt. Describe the location, footprint, and height, and the agent places and saves the building as a new layer in your project.

"Place a 10-storey building at the corner of the development site — footprint roughly 30 m × 20 m" "Add a 5-floor building at 59.91, 10.75"

You can specify:

  • Location — coordinates or a place name the camera is currently pointing at
  • Floor count — number of storeys
  • Floor height — per-floor height in metres (default 3 m)
  • Color — fill colour for the extruded mass
  • Label — name shown on the map at the building centroid

After placement, the building appears as a GeoJSON layer in the Layers panel. You can edit its configuration using the Edit Building option in the layer menu — see Parametric Buildings for details.

note

The AI agent places buildings with a flat roof and no setback. To adjust these or any other settings after placement, use the Edit Building option in the Layers panel.

Analyze your data

GeoAI can create charts, tables, and metric cards from the data in your loaded layers:

  • Bar charts — compare attribute values across features
  • Line charts — show trends over time or along a sequence
  • Scatter plots — explore relationships between two attributes
  • Data tables — browse and sort feature attributes
  • KPI / metric cards — highlight a single key figure (total, average, maximum)

These visualizations appear inline in the chat. Click Pin to dashboard on any visualization to add it to the Analytics panel for later reference.

Choose from numbered options

When GeoAI presents a numbered list of choices, clickable option buttons appear below the message. Click a button to select that option without having to type your reply.

Tool call visibility

GeoAI uses tools behind the scenes to take actions (fly to location, search for data, toggle layers, and so on). By default these are hidden to keep the chat clean.

Click the wrench icon in the panel header to show tool call details. When enabled, each tool action appears as an expandable card showing exactly what GeoAI did and what it received back.

This is useful when you want to verify which data source GeoAI queried, or to understand why it took a particular action.

Daily quota

Each organisation has a daily token quota that resets every day. The progress bar at the bottom of the chat panel shows how much of today's quota has been used:

ColourMeaning
GreenPlenty of quota remaining
YellowApproaching the limit (70% or more used)
RedNear the limit (90% or more used)

When the quota is exhausted, GeoAI is unavailable until the following day. Contact your organisation administrator if you need a higher quota.

tip

Simple navigation requests (fly to, switch view, set date) use less quota than complex data discovery or analysis tasks. For quick map navigation you may want to use the viewer controls directly.

Limitations

  • Responses are AI-generated and may occasionally be inaccurate — review outputs before using them in decisions
  • GeoJSON layers added by GeoAI are limited to 200,000 features
  • Adding a layer always requires your approval before it is applied
  • Data source URLs must use http or https — local file paths are not supported
  • Token usage is subject to your organisation's daily quota
  • Cesium Ion layers require a valid Cesium Ion token to be configured in your project settings

Privacy

Conversations are stored per-project and are visible to all project members with editor access or above. They are not visible to members with contributor or viewer roles.

Do not paste sensitive personal data or confidential information into the GeoAI chat.

Tips

  • Be specific when asking GeoAI to find data — mention the country, topic, and time period. For example: "Find flood risk data for the Bergen municipality, Norway, 2023" gets better results than "Find flood data".
  • Use phrases like "Show me", "Find", or "Add" to trigger a geodata search.
  • After GeoAI adds a layer, open the Layers panel to rename it, adjust its style, or reorder it.
  • If GeoAI's first result is not quite right, ask it to refine: "Try a different source" or "Find something more recent".
  • Use the wrench icon to inspect tool calls if you want to know exactly which URL or dataset GeoAI used.
  • To toggle layer visibility without spending quota, use the Layers panel directly.