Tomtom
tomtomTomTom provides a suite of location-based services and APIs, including mapping, routing, traffic information, and geofencing, enabling developers to integrate advanced navigation and location functionalities into their applications.
Acciones disponibles (19)
Cada acción es una operación que el agente puede ejecutar contra este conector. Haz clic en una acción para ver sus parámetros.
List Map FontsTOMTOM_ASSETS_LIST_FONTSAcciónTool to list available font asset versions for map rendering. call after confirming the api key is valid.
TOMTOM_ASSETS_LIST_FONTSAcciónTool to list available font asset versions for map rendering. call after confirming the api key is valid.
Parámetros de entrada
Sin parámetros.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
List Assets SpritesTOMTOM_ASSETS_LIST_SPRITESAcciónTool to list available sprites for a given asset version. use after determining the assetversion.
TOMTOM_ASSETS_LIST_SPRITESAcciónTool to list available sprites for a given asset version. use after determining the assetversion.
Parámetros de entrada
keystringObligatorioA valid TomTom API key.
apiVersionstringAPI version of the service. Current value is '1'.
assetVersionstringObligatorioThe chosen version of the asset. Wildcards are supported, e.g., '3.*'.
assetCategoriesstring[]Optional filter for sprite categories. Possible values: 'map', 'trafficFlow', 'trafficIncidents'.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
List map stylesTOMTOM_ASSETS_LIST_STYLESAcciónTool to list available map styles. use after selecting an asset version to retrieve style options.
TOMTOM_ASSETS_LIST_STYLESAcciónTool to list available map styles. use after selecting an asset version to retrieve style options.
Parámetros de entrada
apiVersionstringObligatorioThe API version of the Orbis Maps service to call. This query parameter takes precedence over any header value.
assetVersionstringObligatorioThe chosen version of the asset (e.g., '1.0' or wildcard '1.*'). See https://developer.tomtom.com/assets-api/documentation/tomtom-orbis-maps/product-information/assets-versioning
assetCategoriesstring[]Optional list of asset categories to filter by. Provide multiple values to filter on multiple categories, e.g., ['vector','raster'].
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Calculate RouteTOMTOM_CALCULATE_ROUTEAcciónTool to calculate driving routes. use when you need directions with optional waypoints and traffic consideration.
TOMTOM_CALCULATE_ROUTEAcciónTool to calculate driving routes. use when you need directions with optional waypoints and traffic consideration.
Parámetros de entrada
endstringObligatorioDestination coordinates as 'lat,lon'.
avoidstringFeatures to avoid (comma-separated), e.g., 'tollRoads,highways'.
startstringObligatorioOrigin coordinates as 'lat,lon'.
reportstringAdditional report fields, e.g., 'effectiveSettings,travelTimes'.
trafficbooleanWhether to consider live traffic data.
languagestringLanguage for instructions and results.
arrive_atstringArrival time in ISO 8601 format.
depart_atstringDeparture time in ISO 8601 format.
waypointsstringIntermediate waypoints as 'lat,lon:lat,lon'.
route_typestringenumRoute calculation strategy.
fastestshortestecothrillingtravel_modestringenumMode of transport.
cartrucktaxibusvanmotorcyclebicyclepedestriansection_typestringComma-separated list of section types to include, e.g., 'traffic,toll'.
instructions_typestringenumFormat of guidance instructions.
codedtexttagged
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Category SearchTOMTOM_CATEGORY_SEARCHAcciónTool to search for points of interest by category. use when you need to find pois within a specific category around a location or area.
TOMTOM_CATEGORY_SEARCHAcciónTool to search for points of interest by category. use when you need to find pois within a specific category around a location or area.
Parámetros de entrada
extstringComma-separated extra POI fields to include (e.g., 'openingHours,contact')
latnumberLatitude of the search center (decimal degrees)
lonnumberLongitude of the search center (decimal degrees)
ofsintegerOffset for pagination of results
bboxstringBounding box to restrict results in 'minLat,minLon,maxLat,maxLon' format
viewstringGeopolitical view for the search (e.g., 'Unified')
limitintegerMaximum number of results to return (default: 10, max: 100)
idxSetstringComma-separated indexes/data sources to use (e.g., 'POI,ADR')
radiusintegerSearch radius in meters (requires lat & lon)
categorystringObligatorioCategory ID(s) or keywords to search for (path parameter)
languagestringIETF language tag for response localization
countrySetstringComma-separated list of ISO country codes to limit search
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
EV Charging Stations AvailabilityTOMTOM_EV_CHARGING_STATIONS_AVAILABLEAcciónTool to retrieve ev charging station availability info. use when you have the connectorsetid and poiid to get live availability.
TOMTOM_EV_CHARGING_STATIONS_AVAILABLEAcciónTool to retrieve ev charging station availability info. use when you have the connectorsetid and poiid to get live availability.
Parámetros de entrada
poiIDstringObligatorioPOI (charging station) identifier.
operatorIDstringEVSE operator identifier.
connectorSetIDstringObligatorioIdentifier of an EV connector set.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Flow Segment DataTOMTOM_FLOW_SEGMENT_DATAAcciónTool to retrieve traffic flow data for a specific road segment. use when you need current and free flow speeds for given coordinates.
TOMTOM_FLOW_SEGMENT_DATAAcciónTool to retrieve traffic flow data for a specific road segment. use when you need current and free flow speeds for given coordinates.
Parámetros de entrada
unitstringenumUnit for speed values.
KMPHMPHzoomintegerObligatorioZoom level for the flow segment data (0-22).
pointstringObligatorioCenter point of the segment in 'lat,lon' format.
stylestringObligatorioDisplay style of the flow data.
formatstringObligatorioenumResponse format of the data.
jsonxmlopenLrbooleanWhether to include OpenLR descriptors in the response.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Fuzzy SearchTOMTOM_FUZZY_SEARCHAcciónTool to perform a fuzzy search for addresses and points of interest. use when you need flexible matching on free-form location queries.
TOMTOM_FUZZY_SEARCHAcciónTool to perform a fuzzy search for addresses and points of interest. use when you need flexible matching on free-form location queries.
Parámetros de entrada
latnumberLatitude for contextual biasing
lonnumberLongitude for contextual biasing
ofsintegerStarting offset for returned results
viewstringenumGeopolitical view for geography rendering
UnifiedARlimitintegerMaximum number of results to return
querystringObligatorioFree-form search text for address or POI
idxSetstringComma-separated index types (e.g., 'PAD,Geo,Addr')
radiusintegerBias radius in meters around lat/lon
geobiasstringenumEnable or disable geobias (default: 'on')
onoffbrandSetstringComma-separated brand names to restrict results
languagestringResponse language (e.g., 'en-US')
countrySetstringComma-separated country codes to restrict results (e.g., 'US,CA')
minPowerKWintegerMinimum power (kW) for EV charging stations
boundingBoxstringLimit to bounding box: 'minLon,minLat,maxLon,maxLat'
categorySetstringComma-separated category IDs (e.g., '7315,9362')
relatedPoisstringenumReturn related POIs: 'off', 'child', or 'all'
offchildallcategoryTypestringenumRestrict to POI or geography categories
POIGeographyconnectorSetstringComma-separated EV connector types (e.g., 'IEC_62196_T2')
openingHoursstringenumFilter by opening hours
nextSevenDaysnextLocalDayentityTypeSetstringComma-separated entity types to restrict
politicalViewstringPolitical view parameter for geography rendering
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
List Sprite VersionsTOMTOM_LIST_SPRITE_VERSIONSAcciónTool to list available sprite asset versions. use when you need to know which sprite versions are available after obtaining a valid api key.
TOMTOM_LIST_SPRITE_VERSIONSAcciónTool to list available sprite asset versions. use when you need to know which sprite versions are available after obtaining a valid api key.
Parámetros de entrada
Sin parámetros.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get Map CopyrightsTOMTOM_MAP_DISPLAY_COPYRIGHTSAcciónTool to retrieve copyright information for a specific map tile. use when you need to display or verify attribution for a given tile.
TOMTOM_MAP_DISPLAY_COPYRIGHTSAcciónTool to retrieve copyright information for a specific map tile. use when you need to display or verify attribution for a given tile.
Parámetros de entrada
xintegerObligatorioX coordinate of the map tile (non-negative).
yintegerObligatorioY coordinate of the map tile (non-negative).
zoomintegerObligatorioMap zoom level (non-negative).
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
MAP_DISPLAY_RASTER_TILETOMTOM_MAP_DISPLAY_RASTER_TILEAcciónTool to retrieve a raster map tile for specified coordinates and zoom. use when you need direct tile image data for custom map rendering.
TOMTOM_MAP_DISPLAY_RASTER_TILEAcciónTool to retrieve a raster map tile for specified coordinates and zoom. use when you need direct tile image data for custom map rendering.
Parámetros de entrada
XintegerObligatorioTile X coordinate (integer ≥ 0).
YintegerObligatorioTile Y coordinate (integer ≥ 0).
viewstringView parameter, typically 'Unified'.
zoomintegerObligatorioZoom level between 0 (world) and 22 (max detail).
layerstringenumMap layer style.
basichybridstylestringenumVisual theme of the map.
mainnightlabelsformatstringenumImage format to return.
pngjpglanguagestringLanguage code for map labels, e.g., 'en-GB'.
tileSizeintegerenumTile size in pixels, either 256 or 512.
256512
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Map Display Static ImageTOMTOM_MAP_DISPLAY_STATIC_IMAGEAcciónTool to fetch a static map snapshot given center coords and zoom. use when you need a standalone map image for display.
TOMTOM_MAP_DISPLAY_STATIC_IMAGEAcciónTool to fetch a static map snapshot given center coords and zoom. use when you need a standalone map image for display.
Parámetros de entrada
bboxstringBounding box 'min_lon,min_lat,max_lon,max_lat'.
viewstringMap view parameter, e.g., 'Unified', 'Auto', 'AR'.
zoomintegerObligatorioZoom level between 0 (world) and 22 (max detail).
layerstringenumMap layer type.
basichybridlabelsstylestringenumMap style.
mainnightwidthintegerImage width in pixels (1-2000).
centerstringObligatorioCoordinates of the map center as 'lat,lon'.
formatstringenumOutput image format.
pngjpgheightintegerImage height in pixels (1-2000).
markersstringOverlay markers; format 'color|label|lat,lon;color|label|lat,lon'.
trafficbooleanWhether to overlay real-time traffic data.
languagestringLanguage code for map labels, e.g., 'en-US'.
tileSizeintegerenumTile size in pixels.
256512
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Map Display WMS GetMapTOMTOM_MAP_DISPLAY_WMS_GET_MAPAcciónTool to retrieve a map image via wms getmap. use when you need georeferenced map layers for custom rendering.
TOMTOM_MAP_DISPLAY_WMS_GET_MAPAcciónTool to retrieve a map image via wms getmap. use when you need georeferenced map layers for custom rendering.
Parámetros de entrada
crsstringCoordinate Reference System for WMS 1.3.0, e.g., 'EPSG:4326'
srsstringCoordinate Reference System for WMS 1.1.1, e.g., 'EPSG:4326'
bboxstringObligatorioBounding box in 'minx,miny,maxx,maxy' format
timestringTime parameter for time-enabled layers
widthintegerObligatorioImage width in pixels, must be >= 1
formatstringObligatorioImage format, e.g., 'image/png' or 'image/jpeg'
heightintegerObligatorioImage height in pixels, must be >= 1
layersstringObligatorioComma-separated list of map layers to display
stylesstringComma-separated list of layer styles; empty for default
bgcolorstringBackground color in hex, e.g., '0xFFFFFF'
requeststringObligatorioRequest type, must be 'GetMap'
servicestringObligatorioService type, must be 'WMS'
versionstringObligatorioenumWMS version to use
1.1.11.3.0elevationstringElevation parameter for dimension-enabled layers
exceptionsstringException output format, e.g., 'INIMAGE'
transparentbooleanTransparency flag; TRUE for transparent background
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Matrix RoutingTOMTOM_MATRIX_ROUTINGAcciónTool to calculate travel time and distance matrix between multiple locations. use when you require a matrix of travel times and distances between multiple origins and destinations.
TOMTOM_MATRIX_ROUTINGAcciónTool to calculate travel time and distance matrix between multiple locations. use when you require a matrix of travel times and distances between multiple origins and destinations.
Parámetros de entrada
optionsobjectOptional routing and vehicle profile settings
originsobject[]ObligatorioList of origin coordinates (must contain at least one origin)
destinationsobject[]ObligatorioList of destination coordinates (must contain at least one destination)
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Nearby SearchTOMTOM_NEARBY_SEARCHAcciónTool to find points of interest near a specified location. use after confirming coordinates to discover nearby pois.
TOMTOM_NEARBY_SEARCHAcciónTool to find points of interest near a specified location. use after confirming coordinates to discover nearby pois.
Parámetros de entrada
latnumberObligatorioLatitude of the center point for the search
lonnumberObligatorioLongitude of the center point for the search
limitintegerMaximum number of results to return (default: 10, max: 100)
radiusintegerSearch radius in meters (default: 10000, max: 50000)
brandSetstringComma-separated list of brand IDs to restrict the results
countrySetstringComma-separated list of country codes to restrict results
minPowerKWintegerMinimum power in kW for charging stations
categorySetstringComma-separated list of category IDs to restrict the search
connectorSetstringComma-separated list of connector IDs for charging stations
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Points of Interest SearchTOMTOM_POINTS_OF_INTEREST_SEARCHAcciónTool to search for points of interest by query. use when you need poi suggestions by name or category.
TOMTOM_POINTS_OF_INTEREST_SEARCHAcciónTool to search for points of interest by query. use when you need poi suggestions by name or category.
Parámetros de entrada
latnumberLatitude for location bias
lonnumberLongitude for location bias
ofsintegerStarting offset for returned results
viewstringRestrict results to specified map view region
limitintegerMaximum number of results to return
querystringObligatorioSearch term, category, or brand name
idxSetstringComma-separated list of indices to include (POI, Geography)
radiusintegerRadius in meters for search area
fuelSetstringComma-separated fuel types
brandSetstringComma-separated list of brand names
languagestringISO 639-1 language code for result labels
timeZonebooleanOutput local time for opening hours
typeaheadbooleanReturn incomplete results as users type
countrySetstringComma-separated ISO 3166-1 alpha-2 country codes for restricting search
entityTypestringRestrict search to specific entity type
categorySetstringComma-separated list of category IDs
relatedPoisstringReturn related POIs (e.g., 'child', 'all')
categoryBiasstringCategories to bias in result ranking
connectorSetstringComma-separated EV connector types
openingHoursstringFilter POIs by opening hours (e.g., 'nextSevenDays')
maxFuzzyLevelintegerMaximum typo-correction level
minFuzzyLevelintegerMinimum typo-correction level
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Reverse GeocodeTOMTOM_REVERSE_GEOCODEAcciónTool to convert geographic coordinates into a human-readable address. use when you need to obtain address information from latitude and longitude values.
TOMTOM_REVERSE_GEOCODEAcciónTool to convert geographic coordinates into a human-readable address. use when you need to obtain address information from latitude and longitude values.
Parámetros de entrada
latnumberObligatorioLatitude in decimal degrees.
lonnumberObligatorioLongitude in decimal degrees.
numberstringStreet number for more precise results.
radiusintegerSearch radius in meters (default: 100).
languagestringLanguage for the results, e.g., 'en-US'.
entityTypestringRestrict results to a specific entity type, e.g., 'CountrySubdivision'.
returnRoadUsebooleanInclude road use information (true or false).
returnSpeedLimitbooleanInclude speed limit information (true or false).
allowFreeformNewlinebooleanAllow or disallow newlines in freeform address output.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Structured GeocodeTOMTOM_STRUCTURED_GEOCODEAcciónTool to convert structured address fields into coordinates. use after collecting street, city, and postal code.
TOMTOM_STRUCTURED_GEOCODEAcciónTool to convert structured address fields into coordinates. use after collecting street, city, and postal code.
Parámetros de entrada
keystringObligatorioYour TomTom API Key
latnumberLatitude to bias results
lonnumberLongitude to bias results
citystringCity name
viewstringMap view for biasing results, e.g., 'Unified', 'EU', 'IN'
limitintegerMaximum number of results to return (1–100)
radiusintegerRadius in meters to bias results around lat/lon
languagestringIETF BCP 47 language tag for response
postalCodestringPostal code
streetNamestringStreet name
countryCodestringCountry ISO 3166-1 alpha-2 code
municipalitystringAdministrative municipality
streetNumberstringStreet number
freeformAddressstringComplete address as free-form string. Overrides structured fields.
countrySubdivisionstringState, province, or region
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Traffic IncidentsTOMTOM_TRAFFIC_INCIDENTSAcciónTool to retrieve detailed traffic incidents within a bounding box. use when you need incident details for a defined map area.
TOMTOM_TRAFFIC_INCIDENTSAcciónTool to retrieve detailed traffic incidents within a bounding box. use when you need incident details for a defined map area.
Parámetros de entrada
fieldsstringComma-separated incident fields to include, e.g., 'id,geometry,properties'.
formatstringenumResponse format.
jsonxmlmax_latnumberObligatorioMaximum latitude (northeast) of bounding box.
max_lonnumberObligatorioMaximum longitude (northeast) of bounding box.
min_latnumberObligatorioMinimum latitude (southwest) of bounding box.
min_lonnumberObligatorioMinimum longitude (southwest) of bounding box.
languagestringLanguage code for the response.
projectionstringMap projection for geometry coordinates.
original_positionbooleanWhether to include original position of incidents.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not