Use caseairportbaggagerfid

Airport terminal operations on a live map: RFID bag tags, queues and gates

Baggage RFID tracking from bag drop to carousel, plus security, immigration, gates and terminal crowding on one live two-floor map of the airport terminal.

9 min readPublished By Spatial Map team
Silverbay International Airport Terminal 2 in the 3D preview on its arrivals level: baggage carousels with reader markers RD-CF-1 to RD-CF-4, East and West escalators and core lifts, people-per-hour counters, temperature and air-quality readings, and gateway markers

Key takeaways

A terminal is a chain of hand-offs

Follow one passenger through a terminal and count the systems. Check-in and bag drop belong to one team, the screening lanes to another, border control to a third. Gates run off the flight schedule, baggage reclaim off the arrivals feed, and lifts, escalators and jet-bridges off the building and maintenance systems. Retail, food, lounges and restrooms each have their own operators. Every one of these tools knows its own numbers. Very few of them know where those numbers sit in the building.

That is the gap a live terminal map fills. Instead of another dashboard of totals, the plan of each floor becomes the shared index: the bag-drop island, security lane 4, the immigration hall, a gate and its jet-bridge, carousel 3. Every feed lands on the shape it describes, so the operations centre, the duty manager and the baggage team read the same picture. In Spatial Map that picture is a browser-based 3D map with live data links, and reports built on the same tables.

2
floors
26
tables
21
reports
22
tracked assets

Model both floors once

Everything starts with the building. In the editor you place each floor’s plan — a PDF is scaled from its sheet size, a DWG drawing is rendered as a floor-plan image, or use a PNG or JPG — at true scale on a real basemap, so the kerb, the forecourt and the airside edge line up with the terminal outline. Then you trace what operations care about. In Silverbay that means:

  • Check-in islands, security lanes and immigration booths — drawn as areas, so each one can be coloured or badged from its own row of data.
  • Gates with jet-bridges — the gate areas the departures feed attaches to, plus the bridges whose status is reported alongside the lifts and escalators.
  • Baggage reclaim, retail, food and lounges — carousels, shops, cafés, lounges and restrooms as areas and markers.
  • Lifts and escalators — drawn in 3D and linked from one floor to the next, so the two levels read as one building.
An escalator selected in the editor (shown on Retail Mart Store)
Spatial Map editor on the Retail Mart Store floor plan with an escalator selected; the side panel shows Move, Rotate, Duplicate and Delete actions, a rotation slider, Escalator or Elevator, Direction Up or Down, Layout Single or Up + down pair, and From floor and To floor pickers
Spatial Map editor on the Retail Mart Store floor plan with an escalator selected; the side panel shows Move, Rotate, Duplicate and Delete actions, a rotation slider, Escalator or Elevator, Direction Up or Down, Layout Single or Up + down pair, and From floor and To floor pickers

Select a lift or escalator and the side panel sets its kind, its direction, a single unit or an up + down pair, and the floors it connects. The lifts and escalators guide covers the details, and the multi-floor example walks through stacking levels and linking them, step by step.

RFID bag tags: every read is a row

Baggage tracking with RFID is simpler than it sounds. A tag on the bag carries an ID. Fixed readers sit at known points along the bag’s journey — the bag drop, the belts and transfer points, the carousel. Each time a bag passes a reader, the reader or its middleware produces one read: which tag, which read point, what time. Each read is a row. Spatial Map does not talk to readers itself; it stores and shows the rows your system sends.

From bag-tag reads to the live terminal mapFixed RFID readers at bag drop, along the belts and at the carousel produce one read per bag per point. Middleware sends each read as a row to a table through its write API. Data links bind the rows to the map, which feeds the live two-floor view, reports and share links.

In the Silverbay demo that feed lands in a table called Bag Tags, next to Baggage Carousels for the reclaim belts themselves. A row needs only a few fields to be useful on a map:

  • Tag ID — the key that identifies the bag.
  • Read point — named exactly like the area or marker on the map: the bag drop, a belt reader, carousel 3.
  • Read time — when the reader saw the tag.
  • Flight and floor — so a saved filter can narrow the layer to one flight, and the floor scope can read the level from each row.

There are two ways to shape the table, and the table write API supports both. Append one row per read and you get an event log: count reads per read point, chart them by hour, or draw them as a Heatmap of activity. Or keep one row per tag and update its read point at each read: the map then shows where each bag is now, and the table’s change log keeps every earlier read. Open a point’s detail drawer and its History section lists those changes; if the rows carry coordinates, a Historical movement layer replays them with a player — see table history. Either way, batch reads into bulk calls: each API key allows 60 requests a minute, and a bulk call counts as one.

Create new table
Create new table page: a Table name field and “What kind of data is this?” cards for Polygon / area, Circle, Marker / POI, Asset (mobile), Camera, Sensor, Shipment, RFID tag and Streaming / batch replay, with a Choose its fields list below that starts with External code and Longitude
Create new table page: a Table name field and “What kind of data is this?” cards for Polygon / area, Circle, Marker / POI, Asset (mobile), Camera, Sensor, Shipment, RFID tag and Streaming / batch replay, with a Choose its fields list below that starts with External code and Longitude

From operational question to layer

The quickest way to design a terminal map is to start from the questions the operations centre asks, then pick the data and the display mode that answer each one. The table names below are the ones in the Silverbay demo; the display modes are the ones we would reach for.

QuestionDataDisplay mode
Where are the bags for this flight?Bag Tags — one row per read, or per tagLive location marker or Heatmap of activity
Which security lanes are slow?Security Throughput — passengers per laneValue badge on shape + style rules
Is the immigration queue growing?Immigration Queue Log — queue readings over timeColor a shape + a chart in the report
Which flight leaves from which gate?Departure Flights — one row per flight with its gateInfo marker on shape
Which carousel has which arrival?Baggage Carousels — one row per carouselInfo marker on shape + style rules
Which terminal zones are crowded?Occupancy sensors per terminal zoneColor a shape or Heatmap of activity
Is every lift, escalator and jet-bridge running?One row per unit with a statusPulsing zone activity + style rules

Style rules do the colouring, and the first matching rule wins, so a lane over its threshold turns amber before the generic green rule is reached. Saved filters narrow a link to the rows that matter — only open lanes, or only flights still to board — and the tooltip and content panel show just the fields you pick. The display modes guide lists all nine modes, and style rules explains how ordering works.

Connect fields in the data link dialog
Edit data link dialog on step 6 Connect fields: Longitude set to lng, Latitude to lat, Elevation from the field elevation_m and Label field name, with step 7 Style below showing a live preview of a green live location marker, icon and marker colours and an icon picker
Edit data link dialog on step 6 Connect fields: Longitude set to lng, Latitude to lat, Elevation from the field elevation_m and Label field name, with step 7 Style below showing a live preview of a green live location marker, icon and marker colours and an icon picker

21 reports, one per job

The map tells you where; reports tell you how many and how fast. Reports in Spatial Map read the same tables as the map, so there is no export step and no second pipeline. Silverbay carries 21 reports. Eight are the built-in facility reports every facility gets, which count what is drawn on the plan. Among the others are the terminal’s own reports, each named with a “Silverbay ·” prefix:

  • Gates & Departures — departures by gate, from the Departure Flights table.
  • Check-in & Bag Drop — the check-in islands and the bag-drop end of the bag-tag feed.
  • Security Screening — throughput per security lane, from Security Throughput.
  • Immigration & Border Control — the immigration booths and the Immigration Queue Log.
  • Arrivals & Baggage Reclaim — the carousels and the reclaim end of the bag-tag feed.
  • Terminal Crowding — live occupancy by terminal zone.
  • Retail, F&B & Lounges and Restrooms & Passenger Services — the commercial and service side of the terminal.
  • Lifts, Escalators & Jet-bridges — the status of everything that moves people between levels and onto aircraft.

Any report with a facility map & list can be opened as a full-map report: the live terminal fills the screen, the list floats on the left, key numbers run along the top and charts sit in an Insights panel. It updates itself every 30 seconds by default, which suits a wall screen in the operations centre. Reports can be filtered, starred and exported to PDF, Excel, CSV or JSON, and the full-map command center example builds one from scratch.

A full-map report of RFID readers (shown on Retail Mart Store)
Full-map report Retail Mart · RFID Live Map: a list of RFID readers with status, floor and reads today on the left, the store on the live map, key numbers for 85 rows, total reads today and reads in the last hour, and an Insights panel with a By status donut for Active, Idle and Offline and a Reads today by floor bar chart
Full-map report Retail Mart · RFID Live Map: a list of RFID readers with status, floor and reads today on the left, the store on the live map, key numbers for 85 rows, total reads today and reads in the last hour, and an Insights panel with a By status donut for Active, Idle and Offline and a Reads today by floor bar chart

The screenshot shows the same pattern on a retail demo: readers on doorways instead of bag-drop and carousel read points, reads today instead of bags. Swap the source and the layout carries over to a terminal unchanged.

Lifts, escalators, jet-bridges and passenger services

A terminal on two floors depends on its vertical circulation. When a lift is out, passengers with reduced mobility need another way up; when an escalator stops, the queue moves somewhere else. Silverbay draws its lifts and escalators in 3D between the two levels, and its Lifts, Escalators & Jet-bridges report keeps every unit’s status in one list. On the map, a status layer with style rules makes a stopped unit stand out at a glance.

The same approach covers the passenger side of the building:

  • Restrooms — a status or cleaning field per restroom, coloured by style rules.
  • Retail, food and lounges — occupancy or opening state per unit as a value badge.
  • Passenger equipment and staff — BLE tags located in the terminal, shown as live location markers. More in real-time indoor asset tracking.
  • Device and gateway health — the last event per gateway, so a silent reader is visible on the map before its gap shows up in a report.

The model that powers the operations centre also answers the passenger’s question: how do I get there? Pick a start and a destination and the viewer draws a walking route around walls and through doors, with turn-by-turn steps — on share links too. Routes stay on one floor; to change level, route to the lift or escalator first. See wayfinding and our guide to indoor turn-by-turn directions.

A read-only view for every partner

An airport is full of organisations that need to see the terminal but should never edit it: ground handlers, the cleaning contractor, retail operators, the security provider. Share links open a read-only viewer with no account. Each facility can have many links, each with its own settings:

  • Lock the link to one floor — arrivals only, for the reclaim team — or let the viewer switch floors.
  • Choose which data links it shows: the cleaning contractor sees restrooms, not bag tags.
  • Hide whole shape kinds, or turn live data off.
  • Set an expiry and a maximum number of views, and revoke the link at any time.
Share facility dialog, Layout tab (shown on Retail Mart Store)
Share facility dialog for Retail Mart Store on the Layout tab: Default floor plan with All floors (viewer default) or a lock to a single floor, and Layer visibility switches for racks, bins, markers, 3D models, floor plans, text labels, stairs, polygons, circles, lines, doors, image planes and live data
Share facility dialog for Retail Mart Store on the Layout tab: Default floor plan with All floors (viewer default) or a lock to a single floor, and Layer visibility switches for racks, bins, markers, 3D models, floor plans, text labels, stairs, polygons, circles, lines, doors, image planes and live data

“Every hand-off in a terminal happens in a place. Put the places on one map and the hand-offs stop getting lost.”

Try it on your own terminal

Start small. Place one floor’s plan, draw the bag-drop islands and the carousels, and connect one feed — usually the bag-tag reads or the carousel assignments. Add security, immigration, gates and crowding as each system owner comes on board, then the second floor. Group the facility, its reports and its data sources into a solution so the operations team finds them on one page.

Start a 7-day free trial with no credit card; the trial holds up to 5 facilities. After that, Pro is $60/month or $600/year for up to 4 facilities — see pricing.

Try the platform your data belongs on.

Spatial Map turns spreadsheets, sensor streams, and CAD drawings into one live 3D facility view — nothing to install, seven-day free trial.

See it live

Keep reading