UI overview

The GEM User Interface provides a web-based dashboard for managing your matching jobs. This is the recommended approach for users who prefer a guided, visual workflow.

Accessing the UI

Navigate to my.tomtom.com
Log in using your Microsoft Entra ID credentials
Select your project from the dropdown in the left navigation
Click Global Entity Matcher in the sidebar

Note: If the "Global Entity Matcher" option doesn't appear, your organization or project may not have GEM access enabled. Contact your administrator to request access.

Dashboard overview

The GEM dashboard provides a central hub for all matching operations:

Main features

Feature	Description
Job list	View all previous matching jobs with status, timestamps, and details
Search	Find specific jobs by ID
Filters	Filter by status, storage, Overture release, or matching type
Prepare Data	Upload new data to storage
Trigger matching	Start a new matching job

UI capabilities

Data management

Upload data: Guided workflow to upload Parquet files via Azure CLI
Storage selection: Choose from available storage locations
Credential management: Secure access to Azure storage credentials

Job management

Create jobs: Submit matching requests with customizable parameters
Monitor progress: Real-time status updates for running jobs
View details: Access detailed information for each job run
Download results: Retrieve matching results via Azure CLI

Results visualization

Matching statistics: View roads matched, unmatched, and confidence scores
Job history: Track all jobs with timestamps and parameters
Error details: Review error logs for failed jobs

UI vs API comparison

Capability	UI	API
Interactive guided workflow	✅	❌
Visual job monitoring	✅	❌
No coding required	✅	❌
Automation & scripting	❌	✅
Batch operations	❌	✅
CI/CD integration	❌	✅

When to use the UI

The UI is ideal when you:

Are new to GEM and want to explore capabilities
Prefer visual feedback and guided workflows
Run occasional, manual matching jobs
Want to monitor job progress in real-time
Need to quickly check job history and results

Prerequisites

Before using the UI, ensure you have:

Dashboard access: Active account at my.tomtom.com
Project assignment: Assigned to a GEM-enabled project
Azure CLI installed: Required for data upload/download
Data prepared: Parquet files with required schema

See Getting Started for detailed prerequisites.

Next steps

Ready to use the UI? Follow the complete workflow guide:

UI Workflow Guide - Step-by-step instructions for the complete workflow

Or explore other documentation:

API Overview - Learn about programmatic access
Technical Documentation - System architecture details