Tools

Reverse Geocode

Convert geographic coordinates (latitude/longitude) into a human-readable address. Returns the closest matching address, street, or area for the given location.

Matrix Routing

Calculate a matrix of route summaries (travel times and distances) for multiple origin-destination pairs. Useful for finding the nearest facility, comparing multiple destinations, or building distance tables.

Create Geofence Project

Create a new geofencing project. Projects are containers for organizing geofences.

Geofence Position Report

Check whether an object at a given position is inside, outside, or near any geofences in a project. Reports the object's relationship with all fences and records a transition if the object has crossed a fence border.

List Geofence Projects

List all geofencing projects. Projects are used to organize geofences into logical groups for easier administration.

Create Geofence Alert

Create an alert on a geofence that sends notifications when a tracked object enters, exits, or dwells within the fence. Alerts are delivered to a specified notification contact group via webhooks or email.

Snap to Roads

Match raw GPS points to the road network and reconstruct the driven route. Corrects GPS drift by snapping points to the nearest valid road. Returns matched positions along with road details such as speed limits and road names.

Manage Contact Group

Create, update, or list notification contact groups. Contact groups define where geofence alerts and other notifications are delivered, including webhook URLs and email addresses.

Create Geofence

Create a geofence (virtual boundary) within a project. Supports circle, polygon, corridor, and rectangle shapes. Geofences are used to detect when tracked objects enter, exit, or dwell within defined areas.

Get Geofence Transitions

Retrieve the history of geofence border crossings (transitions) for a tracked object. Shows when objects entered or exited specific geofences.

Delete Contact Group

Delete a notification contact group.

List Geofences

List all geofences within a project. Returns fence IDs, names, and geometry information.

Reachable Range

Calculate the area reachable from a given origin within a specified budget (time, distance, fuel, or energy). Returns a polygon boundary representing the reachable area, useful for isochrone/isodistance maps and EV range estimation.

List Geofence Alerts

List all alerts configured on a specific geofence.

Delete Geofence Alert

Delete a geofence alert to stop receiving notifications for a specific transition.

Get Location History

Retrieve a page of position history for a tracked object from a specified time. Requires an Admin Key; the requested time range cannot exceed 24 hours.

Optimize Waypoints

Optimize the visiting order of waypoints for the fastest overall route (traveling salesman problem). Takes a set of locations and returns the optimal sequence, considering traffic and optional time constraints.

Search & Geocode

Search for addresses, places, and points of interest using TomTom's fuzzy search. Bias results around a specific location and filter by country or category. Use autocomplete to recognize query terms and list_poi_categories to discover category IDs.

Delete Geofence Project

Delete a geofencing project and all its associated fences.

Calculate Route

Plan a route between two or more locations, taking into account real-time and historical traffic. Supports multiple route types (fastest, shortest, eco), travel modes, waypoints, and vehicle-specific constraints. Returns route summary with distance, travel time, and traffic delays.

Traffic Flow

Get real-time traffic flow data for a road segment near a given location. Returns current speed, free-flow speed, and congestion level for the closest matching road.

Create Tracked Object

Create a new tracked object in the Location History service. Once created, positions can be reported for this object.

Delete Geofence

Delete a geofence from a project.

List Tracked Objects

List all tracked objects in the Location History service. Objects represent entities (vehicles, devices, etc.) whose positions are being tracked.

Report Object Location

Report a position update for a tracked object. Records the location in the object's history and can trigger geofence transitions when combined with the Geofencing service.

Traffic Incidents

Retrieve real-time traffic incidents within a bounding box area. Returns details about jams, road closures, construction, and other traffic-related events including location, severity, and road information.

List Poi Categories

List TomTom point-of-interest categories, subcategory IDs, and synonyms. Pass selected IDs as comma-separated text to search_geocode categorySet.

Autocomplete Search Terms

Recognize brand names, POI categories, and plain text in a search query. Use returned category IDs with search_geocode categorySet to refine a place search.