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.
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:
| Area | Description |
|---|---|
| Header | Panel title with a "beta" badge, a wrench icon to show or hide tool call details, and a trash icon to clear the conversation |
| Message list | Scrollable history of your conversation with GeoAI |
| Approval cards | Appear when GeoAI wants to add a layer — you must confirm before it is added |
| Quota bar | Shows your organisation's daily token usage (green → yellow → red) |
| Chat input | Auto-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"
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"
Noise data search
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 type | Example 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"
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.
| Analysis | Example 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.
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:
| Colour | Meaning |
|---|---|
| Green | Plenty of quota remaining |
| Yellow | Approaching the limit (70% or more used) |
| Red | Near 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.
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
httporhttps— 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.