The data download service is used for querying available data and downloading the data as needed. The data should be sharing static data that is either common to all customers or generated for specific customers. Map release data is the first to be supported. And it can be extended to support other product deliverables that are static in nature.
Generally, all data are organized in a hierarchy based on their nature. The top level is always the product itself, which is represented by its name, and then followed by necessary sub levels, down to each individual data file. For example, map data are organized in a hierarchy like:
—-Top level Product: Map Release
—-Sub level Datasets: XDReplaced, OSMConflation, TMCRemoved, XDRemoved, OpenLRDictionaryFiles, GeoJSON, TMCAdded, Shapefiles, TMCReplaced, XDAdded
—-Lowest level: Data files under each dataset.
All APIs requires authentication. You need to get the auth token from INRIX User Account System before you make service API call.
The service production endpoint, which should only be used with real data, is:
https://mapdata.inrix.io
For testing purposes the “qa” endpoint is available:
https://mapdata.qa.inrix.io
Instead of using service APIs for data downloading, a portal is provided. Below are their URLs:
POSTsubmit a data download request based on the provided search criteria, such as data product, dataset, version, countrycode, datafile id, geoid and statecode, etc. The query works depends on the combination of these criteria
Parameters
= required
Name
Located In
Type
Description
Bearer Token
Header
String
a valid UAS token from https://uas-api.inrix.com
accessToken
Query
String
a valid UAS token from https://uas-api.inrix.com
dataproduct
Query
String
the name of the data product the data files belong to. It is required if data file id is not provided
dataset
Body
String
the name of the dataset the data files belong to. It is required if data file id or geoid is not provided
version
Body
String
the version of the product. It is required if data file id is not provided
geoids
Body
Array
of
the list of geoid to which the data file belongs
countrycode
Body
String
the iso-3 code of the country the data files belong to. It is required if data file id or geoid is not provided
statecode
Body
String
the 2-letter code of the state or province the data files belong to if it is available
datafileids
Body
Array
of
a list of the data file ids. This parameter does not require any other parameters
Requests
Example
Submit a download request to ask for all files given country AUT, version 20.1 and dataset OpenLRDictionaryFiles
GETquery the detail of the data files based on the provided search criteria, such as data product, dataset, version, countrycode, datafile id, geoid and statecode, etc.
Parameters
= required
Name
Located In
Type
Description
Bearer Token
Header
String
a valid UAS token from https://uas-api.inrix.com
accessToken
Query
String
a valid UAS token from https://uas-api.inrix.com
dataproduct
Query
String
the name of the data product the data files belong to
dataset
Query
String
the name of the dataset the data files belong to
version
Query
String
the version of the product
geoid
Query
Array
of
the geoid the data file belongs to
countrycode
Query
String
the iso-3 code of the country the data files belong to
statecode
Query
String
the 2-letter code of the state or province the data files belong to if it is available