VectorGIS

User & Administrator Guide
Version 1.0 · June 2026 · vectorgis.ai

Welcome to VectorGIS

VectorGIS turns your organization's spatial data into something anyone can use — no GIS training required. Instead of learning query languages, map layers, or attribute tables, you simply ask a question in plain language and VectorGIS finds the answer, explains it, and shows it on the map.

What makes VectorGIS different:

You don't need to understand any of the technology behind this to use it. If you can type a question, you can use VectorGIS.

Behind the scenes, VectorGIS pairs a natural-language understanding engine with your live GIS database. When you ask "Who owns the property at 123 Main St?" or "Show me the water lines installed before 1980," the system interprets your intent, looks up the right data, and returns a clear answer alongside an interactive map.

This guide is in two parts:

Tip You don't have to read this guide front to back. Each feature is self-contained — jump to the section you need using the Contents page.

Part 1 — Using VectorGIS

Signing in

VectorGIS signs you in with your organization's existing ArcGIS Online account. There is no separate VectorGIS username or password to create or remember — if you can sign in to your organization's ArcGIS Online (or ArcGIS Enterprise) portal, you can sign in to VectorGIS.

The VectorGIS sign-in screen, which hands off to your organization's ArcGIS Online login.
The VectorGIS sign-in screen, which hands off to your organization's ArcGIS Online login.

When you open VectorGIS, you're sent to your organization's familiar ArcGIS Online login. Sign in there, and you're returned to VectorGIS ready to work. Because access rides on your ArcGIS Online account:

Note If you can't sign in, it's almost always an ArcGIS Online account question — contact whoever manages your organization's ArcGIS Online users.

The main screen at a glance

When you sign in, VectorGIS opens to a split view: the question panel on one side and the interactive map on the other. Everything you do starts from one of these two areas.

The VectorGIS main screen, showing the question panel on the left and the live map on the right.
The VectorGIS main screen, showing the question panel on the left and the live map on the right.

The key elements are:

Element What it does
Ask box Type any question about your GIS data here, then press Search.
Enable Analysis Mode A toggle that switches between quick answers and deeper analytical breakdowns.
Start project Begins a named project so related answers are grouped and saved together.
Map / selection tools The live map, with on-map tools for selecting features by rectangle or lasso.
Results area Where answers appear as cards, each with sources, feedback, and tagging controls.

Asking a question

This is the heart of VectorGIS. Click into the "Ask a question about GIS data…" box, type a question the way you'd say it out loud, and press Search (or hit Enter).

Typing a natural-language question into the Ask box.
Typing a natural-language question into the Ask box.

You can ask about:

VectorGIS automatically decides whether your question needs a direct database lookup, a spatial calculation, or a descriptive answer drawn from your reference documents — you never have to specify which.

Tip Be specific when it matters. "Permits on Main Street" casts a wide net; "How many electrical permits were issued on Main Street in 2025?" gets you a precise count.

What VectorGIS can and can't answer

VectorGIS only knows what's in your organization's own GIS database — the layers, attributes, and reference documents that have been loaded for your account. The one exception is location lookup: to resolve an address or place name you mention, it can call Esri's World Geocoding Service to turn that text into coordinates. Beyond that, it does not search the web, "Google" anything, or reach into any other database, spreadsheet, or set of files. If a fact isn't in your GIS data, VectorGIS won't have it — so an empty or low-confidence answer usually means the information simply isn't in the data you've connected, not that the question was asked wrong.

It's also worth knowing that VectorGIS answers questions — it doesn't act on them. It is not an agentic assistant: you can't tell it to edit a record, change data, send an email, or carry out a task on your behalf. It reads your data and reports back; any changes to the underlying data are still made through your normal GIS tools.

Reading an answer card

Every answer comes back as a card in the results area. A card contains the answer itself plus a set of controls along the bottom edge.

An answer card showing the answer text, a match-quality badge, source references, and the feedback controls.
An answer card showing the answer text, a match-quality badge, source references, and the feedback controls.

When a question returns multiple matching features, use the Previous feature (‹) and Next feature (›) arrows on the card to step through them one at a time; the map highlight follows along.

Related tasks come up with every answer

You're never only searching your map data. Every search also looks through your tasks automatically, so each answer card includes a task panel with two tabs:

Each listed task shows its status, priority, and assignee, with a View button to open it. So a single question tells you both what's there and what work is already happening around it — you don't run a separate task search to find out.

Analysis Mode

Flip the Enable Analysis Mode toggle before searching when you want VectorGIS to break down an answer rather than just state it. Analysis Mode is ideal for questions where the "why" or the "how much" matters.

The Enable Analysis Mode toggle in its on position, and an answer card with an Analysis tab.
The Enable Analysis Mode toggle in its on position, and an answer card with an Analysis tab.

With Analysis Mode on, answer cards gain an Analysis tab alongside the standard answer. The Analysis view shows the reasoning, intermediate numbers, and any calculations VectorGIS performed — useful for reports, audits, or double-checking a surprising result.

Note Analysis Mode may take slightly longer to respond because it does more work per question. Leave it off for quick lookups; turn it on when you need the detail.

Working with the map

The map is fully interactive and stays in sync with your answers.

The interactive map with a set of features highlighted from a query result.
The interactive map with a set of features highlighted from a query result.

Selecting several features at once

When you want to select several features at once — for example, every parcel in a block — use the selection tools in the small strip on the left edge of the map, just below the zoom buttons.

The map's selection tools on the left edge, with the rectangle tool active and a selection box drawn across two parcels.
The map's selection tools on the left edge, with the rectangle tool active and a selection box drawn across two parcels.
Tool What it does
▭ Rectangle select Drag a box across the features you want.
◌ Lasso select Draw a freehand shape around the features you want.
✕ Clear selection Clears the current selection, and cancels a lasso you're part-way through.

The second strip, directly below these three, is the measurement tools (distance, area, and clear) — a separate set that has nothing to do with selection.

  1. Click the tool you want — it highlights to show it's armed.
  2. Drag the box, or draw the lasso.
  3. The matching features are selected and highlighted, and a selection card appears in the results panel.

The tool disarms itself after one selection, so the map goes straight back to normal panning and zooming — click it again for the next selection. Clicking an armed tool a second time also disarms it without selecting anything.

Two things are worth knowing about what gets caught:

To select just one feature, click it on the map; that replaces whatever was selected before.

Tip On a desktop you can Shift-drag to draw a selection box at any time, without arming the rectangle tool first. The on-map tools exist mainly so the same gestures work on touchscreens and tablets in the field, where there is no Shift key.

Projects: organizing your work

A project groups related answers under one name, so a day's worth of research or a single investigation stays together instead of scrolling away. But a project is more than a folder — it's how VectorGIS remembers a conversation.

Creating a project: the Start project menu open, with a field to name a new project.
Creating a project: the Start project menu open, with a field to name a new project.

To start a project:

  1. Click Start project ▾ at the top of the question panel.
  2. Choose an existing project or type a new project name (up to 60 characters).
  3. Once a project is active, a banner shows its name, and new answers are associated with it automatically.
A project that is open: the banner at the top of the question panel shows the active project's name.
A project that is open: the banner at the top of the question panel shows the active project's name.

To add an individual question and answer to the active project, click the Tag control on that answer card. (There is no "save" button — tagging is how you save.) To switch projects, open the Start project menu again; to clear the active project, use the Clear active project control on the banner.

Why this matters — projects are conversational. VectorGIS works best as a back-and-forth: you ask, it answers, you refine. When you Tag a question, its answer, and especially any comments you left into a project, you aren't just filing it away — you're saving the context of that exchange. The next time you open that project, VectorGIS can pick the conversation back up: your earlier questions, answers, and comments come back into play, so a follow-up question lands with everything you'd already established still in mind. That's what lets you stop today and resume an investigation days later without starting over.

Note Projects are built on VectorGIS's tagging system. Tagging an answer attaches it to the project — which is how you later retrieve everything that belongs to a given project, and how VectorGIS restores the context of past conversations.

Creating and managing tasks

VectorGIS can turn a finding into a field task — a unit of work you can assign, schedule, and track. This bridges the gap between discovering something in the data and acting on it.

The Task Management panel listing existing tasks with their status.
The Task Management panel listing existing tasks with their status.

You can review existing tasks and their status at any time from the Task Management panel (the task button).

Creating a task

A task always starts from data. The Create Task button only appears on an answer card or a selection card — that is, after you've asked a question that returns one or more features, or after you've selected features on the map. There is no standalone "create a blank task" button, and that's by design: when you click Create Task, VectorGIS attaches the features from your question or selection to the task, so the person doing the work inherits the exact location and data you were looking at.

So the flow is always:

  1. Ask a question that returns features (e.g., "Show the hydrants overdue for inspection") — or select features on the map with the rectangle or lasso tool.
  2. Click Create Task on the resulting answer card or selection card.
  3. Fill in the task form.
The Create Task modal with fields for project name, assignee, contact, and a work description.
The Create Task modal with fields for project name, assignee, contact, and a work description.

The task form includes:

Preview and Analyze

Before you commit a task, use Analyze to have VectorGIS examine the work description and surface the relevant data, location, or features. This produces a Task Summary so the person doing the work has the spatial context they need. Use Continue to move from analysis to a finished task, or Submit to save it directly.

A task analysis result showing the Task Summary VectorGIS generated from the description.
A task analysis result showing the Task Summary VectorGIS generated from the description.

You can later edit a task's details or delete it from the Task Management panel.

Task templates

If your team creates the same kind of task over and over — "inspect hydrant," "verify parcel boundary," "follow up on permit" — an administrator can publish a task template for it. A template is a pre-built task form: it can carry default values and require specific fields, so every task of that type captures the same information in the same way (for example, always recording a meter reading, a condition rating, or an inspector's name). Templates are how your organization keeps field work consistent and makes sure nothing important is left blank — and they can be built for any of your data. Your administrator creates and manages them in the Admin console; see Task Templates in Part 2.

Giving feedback

VectorGIS learns from your feedback, so it gets better at returning the answer you're looking for. Every answer card has feedback controls.

The feedback controls on an answer card: thumbs-up, thumbs-down, and a comment button.
The feedback controls on an answer card: thumbs-up, thumbs-down, and a comment button.

Your feedback is recorded and reviewed by administrators in the Diagnostic Reports console (Part 2). Leaving a comment is the single most valuable thing you can do to improve results for your whole organization.

Tip A with a one-line comment ("I was looking for the current owner, not the previous one") is far more useful than a alone — it tells VectorGIS, and your admin, exactly what you expected.

How your comments come back to help you

Comments aren't just filed away for an administrator to read later — VectorGIS feeds them back into the engine to improve the very next answer.

VectorGIS decides which past comments are relevant by semantic similarity — it matches the meaning of your new question against earlier questions, not just the exact words. So a comment you left on "who owns 123 Main St" can still help when someone later asks "find the property owner at 123 Main Street."

Sessions and signing out

VectorGIS keeps you signed in for a working session. If you've been idle for a long time, you may see a Session Expired notice — just sign in again to continue. Your saved projects and tasks are not affected by a session timeout.


Part 2 — Administration

The Admin console is where designated administrators tune VectorGIS for the organization. Open it at the /admin URL. It is organized into four tabs.

The VectorGIS Admin console showing the four tabs: Task Templates, Query Cache, Diagnostic Reports, and Model Configuration.
The VectorGIS Admin console showing the four tabs: Task Templates, Query Cache, Diagnostic Reports, and Model Configuration.
Admin The Admin console controls live behavior for every user. Changes to model configuration and templates take effect immediately. Review changes carefully before saving.

Task Templates

The Task Templates tab lets you publish reusable task definitions so that common field work can be created in a couple of clicks instead of typed from scratch each time.

The Task Templates tab listing all published templates with Edit and Delete actions.
The Task Templates tab listing all published templates with Edit and Delete actions.

The tab lists All Templates currently published. For each template you can:

Building a template

Click to create a New Template (or Edit an existing one) to open the builder. The builder is essentially a custom form designer: you decide exactly what information must be captured for a task of this type, and the worker is then prompted for it every time.

The template builder modal, where an administrator defines the template's name, layers, and custom fields.
The template builder modal, where an administrator defines the template's name, layers, and custom fields.

Start with the template's basics:

Adding custom fields. Below the basics you build the form itself, adding as many fields as you need. Give each field a label and choose its type:

Field type Use it for Example
Text Free-form notes or short written entries. "Condition notes," "Inspector name"
Integer Whole numbers, so the entry is always numeric. "Meter reading," "Number of defects"
Drop-down list A fixed set of choices you define, so everyone picks from the same options. "Status: Pass / Fail / Needs review"
The custom-field editor, showing a field's label and its type selector (Text, Integer, Drop-down).
The custom-field editor, showing a field's label and its type selector (Text, Integer, Drop-down).

Add a field, choose its type, and — for a drop-down — type in the list of allowed choices. Repeat for every piece of information the task should capture. This is how you guarantee consistent, complete data: if a field is part of the template, it's collected every time, the same way, by everyone.

A drop-down field being configured with its list of allowed choices.
A drop-down field being configured with its list of allowed choices.

Save the template to publish it; it becomes immediately available to users in the task creation flow.

Note If template creation ever fails with a "Failed to create template" error, it almost always points to a database permission on the task-templates table rather than anything you entered. Note the exact message and pass it to your VectorGIS operator.

Query Cache

The Query Cache tab is a log of recent queries and the answers VectorGIS produced. It serves two purposes: performance (repeated questions can be answered from cache) and quality review (you can see exactly what users asked and what they got back).

The Query Cache Log listing recent queries, their generated SQL, and an Apply control.
The Query Cache Log listing recent queries, their generated SQL, and an Apply control.

For each cached entry you can:

Note — what's actually cached: VectorGIS caches the query logic (the SQL), not the wording of the answer. When a repeated question is served from cache, VectorGIS re-runs that saved SQL against your live database and builds a fresh answer from the current data — it does not replay an old, possibly stale answer. So if the underlying data changed since the question was last asked, a cached question still returns up-to-date numbers.

Note — approval also promotes the comment: Approving an entry does more than speed it up. If a user left a comment on that question, approving it also promotes the comment: from then on, when someone asks a semantically similar question, VectorGIS feeds your approved comment to the engine as guidance — so a correction one user made improves results for everyone who asks something similar later.

Reviewing the cache is the fastest way to spot a question that's being interpreted incorrectly — if the generated SQL is querying the wrong layer or filter, you've found the root cause of a bad answer.

Tip Pair the Query Cache with Diagnostic Reports. When a user flags an answer, find the matching cache entry and read its Generated SQL to see precisely where the interpretation went wrong.

Diagnostic Reports

The Diagnostic Reports tab aggregates user feedback and system health into a reviewable report.

The Diagnostic Reports tab with a summary section and a list of flagged entries awaiting admin review.
The Diagnostic Reports tab with a summary section and a list of flagged entries awaiting admin review.

The tab has two parts:

Work through the flagged entries to find patterns: a layer with stale data, a phrasing the classifier misreads, or a missing reference document. Each flagged entry ties back to the question that produced it, so you can reproduce and confirm the issue.

Admin Flagged entries are your prioritized to-do list for improving accuracy. A cluster of flags on similar questions usually means one underlying fix will resolve many complaints at once.

Model Configuration

The Model Configuration tab controls which AI models power VectorGIS and how they behave. There are two independent stages, each separately configurable.

The Model Configuration tab with the Query Classifier and Answer Generation sections and a Save Changes button.
The Model Configuration tab with the Query Classifier and Answer Generation sections and a Save Changes button.

A Common Model Names reference is provided on the tab so you can enter valid model identifiers without guessing.

After changing any value, click Save Changes to apply the new configuration.

Warning Model configuration changes take effect immediately for all users. If you're experimenting, change one stage at a time and run a few test questions (see the Query Cache) before and after, so you can tell exactly what your change did.

Appendix — Tips for getting the best results

Appendix — Glossary

Term Meaning
Feature A single mappable object — a parcel, a hydrant, a water line.
Layer A collection of related features of the same type.
Project / Tag A label that groups answers together; tagging an answer is how you save it to a project.
Conversational VectorGIS keeps the thread of your questions: follow-ups build on earlier ones, and saved projects let a conversation resume later.
Semantic search Matching by meaning rather than exact words, so "who owns 123 Main St" and "find the owner of 123 Main Street" are treated as the same request.
Embedding model The model that turns text into numerical "fingerprints" so VectorGIS can measure how similar two questions are. Chosen once, at deployment.
Analysis Mode A separate search mode that returns a reasoning breakdown alongside the answer.
Selection tools The on-map rectangle and lasso tools for selecting several features at once.
Task A trackable unit of field work created from an answer or selection, with the relevant features attached.
Related Tasks / Task Search The task panel shown with every answer: tasks linked to the returned features, plus tasks that match your question by meaning.
Task template A reusable, admin-built task form with required and default fields, so similar work is captured consistently.
Comment A note you leave on an answer; VectorGIS feeds relevant comments back to improve later answers to similar questions.
Approved (admin) An entry an administrator has cleared so it can serve cache hits and so its comment guides similar future questions.
ArcGIS Online sign-in VectorGIS authenticates through your organization's ArcGIS Online account — there is no separate app password.
Classifier The model that decides how to interpret and route a question.
Generated SQL The database query VectorGIS built from a natural-language question.
Match quality VectorGIS's confidence that a returned feature matches your question.