{
"opencollection": "1.0.0",
"info": {
"name": "Maps Additional Data Search API",
"version": "3.0"
},
"request": {
"auth": {
"type": "apikey",
"key": "key",
"value": "{{key}}",
"placement": "query"
}
},
"items": [
{
"info": {
"name": "Search",
"type": "folder"
},
"items": [
{
"info": {
"name": "Low Bandwith Category Search",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://api.tomtom.com/search/:versionNumber/cS/:category.:ext",
"params": [
{
"name": "versionNumber",
"value": "",
"type": "path",
"description": "Service version number. The current value is 2."
},
{
"name": "category",
"value": "pizza",
"type": "path",
"description": "Query string. Must be properly URL encoded."
},
{
"name": "ext",
"value": "xml",
"type": "path",
"description": "Expected response format."
},
{
"name": "typeahead",
"value": "",
"type": "query",
"description": "If the \"typeahead\" flag is set, the query will be interpreted as a partial input and the search will enter predictive mode."
},
{
"name": "limit",
"value": "",
"type": "query",
"description": "Maximum number of search results that will be returned."
},
{
"name": "ofs",
"value": "",
"type": "query",
"description": "Starting offset of the returned results within the full result set."
},
{
"name": "countrySet",
"value": "FR",
"type": "query",
"description": "Comma separated string of country codes. This will limit the search to the specified countries."
},
{
"name": "lat",
"value": "37.337",
"type": "query",
"description": "Latitude where results should be biased. \nNOTE: supplying a lat/lon without a radius will return search results biased to that point."
},
{
"name": "lon",
"value": "-121.89",
"type": "query",
"description": "Longitude where results should be biased\nNOTE: supplying a lat/lon without a radius will return search results biased to that point."
},
{
"name": "radius",
"value": "",
"type": "query",
"description": "If radius and position are set, the results will be constrained to the defined area. The radius parameter is specified in meters."
},
{
"name": "topLeft",
"value": "37.553,-122.453",
"type": "query",
"description": "Top left position of the bounding box. This is specified as a comma separated string composed of lat., lon."
},
{
"name": "btmRight",
"value": "37.4,-122.55",
"type": "query",
"description": "Bottom right position of the bounding box. This is specified as a comma separated string composed of lat., lon."
},
{
"name": "language",
"value": "",
"type": "query",
"description": "Language in which search results should be returned. Should be one of supported IETF language tags, case insensitive."
},
{
"name": "idxSet",
"value": "POI",
"type": "query",
"description": "A comma separated list of indexes which should be utilized for the search. Item order does not matter. Available indexes are:\n - Addr = Address range interpolation (when there is no PAD)\n - Geo = Geographies\n - PAD = Point Addresses\n - POI = Points of interest\n - Str = Streets\n - Xstr = Cross Streets (intersections)"
},
{
"name": "view",
"value": "",
"type": "query",
"description": "Geopolitical View."
}
]
},
"docs": "Low Bandwith Category Search"
},
{
"info": {
"name": "Category Search",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://api.tomtom.com/search/:versionNumber/categorySearch/:query.:ext",
"params": [
{
"name": "versionNumber",
"value": "",
"type": "path",
"description": "Service version number. The current value is 2."
},
{
"name": "query",
"value": "pizza",
"type": "path",
"description": "Query string. Must be properly URL encoded."
},
{
"name": "ext",
"value": "xml",
"type": "path",
"description": "Expected response format."
},
{
"name": "typeahead",
"value": "",
"type": "query",
"description": "If the \"typeahead\" flag is set, the query will be interpreted as a partial input and the search will enter predictive mode."
},
{
"name": "limit",
"value": "",
"type": "query",
"description": "Maximum number of search results that will be returned."
},
{
"name": "ofs",
"value": "",
"type": "query",
"description": "Starting offset of the returned results within the full result set."
},
{
"name": "countrySet",
"value": "FR",
"type": "query",
"description": "Comma separated string of country codes. This will limit the search to the specified countries."
},
{
"name": "lat",
"value": "37.337",
"type": "query",
"description": "Latitude where results should be biased. \nNOTE: supplying a lat/lon without a radius will return search results biased to that point."
},
{
"name": "lon",
"value": "-121.89",
"type": "query",
"description": "Longitude where results should be biased\nNOTE: supplying a lat/lon without a radius will return search results biased to that point."
},
{
"name": "radius",
"value": "",
"type": "query",
"description": "If radius and position are set, the results will be constrained to the defined area. The radius parameter is specified in meters."
},
{
"name": "topLeft",
"value": "37.553,-122.453",
"type": "query",
"description": "Top left position of the bounding box. This is specified as a comma separated string composed of lat., lon."
},
{
"name": "btmRight",
"value": "37.4,-122.55",
"type": "query",
"description": "Bottom right position of the bounding box. This is specified as a comma separated string composed of lat., lon."
},
{
"name": "language",
"value": "",
"type": "query",
"description": "Language in which search results should be returned. Should be one of supported IETF language tags, case insensitive."
},
{
"name": "extendedPostalCodesFor",
"value": "",
"type": "query",
"description": "Indexes for which extended postal codes should be included in the results. Available indexes are:\n - Addr = Address ranges\n - Geo = Geographies\n - PAD = Point Addresses\n - POI = Points of Interest\n - Str = Streets\n - XStr = Cross Streets (intersections)"
},
{
"name": "view",
"value": "",
"type": "query",
"description": "Geopolitical View."
}
]
},
"docs": "Category Search"
},
{
"info": {
"name": "Geometry Search",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://api.tomtom.com/search/:versionNumber/geometrySearch/:query.:ext",
"params": [
{
"name": "versionNumber",
"value": "",
"type": "path",
"description": "Service version number. The current value is 2."
},
{
"name": "query",
"value": "pizza",
"type": "path",
"description": "Query string. Must be properly URL encoded."
},
{
"name": "ext",
"value": "xml",
"type": "path",
"description": "Expected response format."
},
{
"name": "geometryList",
"value": "[{\"type\":\"POLYGON\", \"vertices\":[\"37.7524152343544, -122.43576049804686\", \"37.70660472542312, -122.43301391601562\", \"37.712059855877314, -122.36434936523438\", \"37.75350561243041, -122.37396240234374\"]}, {\"type\":\"CIRCLE\", \"position\":\"37.71205, -121.36434\", \"radius\":6000}, {\"type\":\"CIRCLE\", \"position\":\"37.31205, -121.36434\", \"radius\":1000}]",
"type": "query",
"description": "List of geometries to filter by. Available types are CIRCLE (with the radius expressed in meters) and POLYGON."
},
{
"name": "limit",
"value": "",
"type": "query",
"description": "Maximum number of search results that will be returned."
},
{
"name": "language",
"value": "",
"type": "query",
"description": "Language in which search results should be returned. Should be one of supported IETF language tags, case insensitive."
},
{
"name": "extendedPostalCodesFor",
"value": "",
"type": "query",
"description": "Indexes for which extended postal codes should be included in the results. Available indexes are:\n - Addr = Address ranges\n - Geo = Geographies\n - PAD = Point Addresses\n - POI = Points of Interest\n - Str = Streets\n - XStr = Cross Streets (intersections)"
},
{
"name": "idxSet",
"value": "POI",
"type": "query",
"description": "A comma separated list of indexes which should be utilized for the search. Item order does not matter. Available indexes are:\n - Addr = Address range interpolation (when there is no PAD)\n - Geo = Geographies\n - PAD = Point Addresses\n - POI = Points of interest\n - Str = Streets\n - Xstr = Cross Streets (intersections)"
}
]
},
"docs": "Geometry Search"
},
{
"info": {
"name": "Geometry Search",
"type": "http"
},
"http": {
"method": "POST",
"url": "https://api.tomtom.com/search/:versionNumber/geometrySearch/:query.:ext",
"params": [
{
"name": "versionNumber",
"value": "",
"type": "path",
"description": "Service version number. The current value is 2."
},
{
"name": "query",
"value": "pizza",
"type": "path",
"description": "Query string. Must be properly URL encoded."
},
{
"name": "ext",
"value": "xml",
"type": "path",
"description": "Expected response format."
},
{
"name": "limit",
"value": "",
"type": "query",
"description": "Maximum number of search results that will be returned."
},
{
"name": "language",
"value": "",
"type": "query",
"description": "Language in which search results should be returned. Should be one of supported IETF language tags, case insensitive."
},
{
"name": "extendedPostalCodesFor",
"value": "",
"type": "query",
"description": "Indexes for which extended postal codes should be included in the results. Available indexes are:\n - Addr = Address ranges\n - Geo = Geographies\n - PAD = Point Addresses\n - POI = Points of Interest\n - Str = Streets\n - XStr = Cross Streets (intersections)"
},
{
"name": "idxSet",
"value": "POI",
"type": "query",
"description": "A comma separated list of indexes which should be utilized for the search. Item order does not matter. Available indexes are:\n - Addr = Address range interpolation (when there is no PAD)\n - Geo = Geographies\n - PAD = Point Addresses\n - POI = Points of interest\n - Str = Streets\n - Xstr = Cross Streets (intersections)"
}
],
"body": {
"type": "json",
"data": "{}"
}
},
"docs": "Geometry Search"
},
{
"info": {
"name": "Nearby Search",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://api.tomtom.com/search/:versionNumber/nearbySearch/.:ext",
"params": [
{
"name": "versionNumber",
"value": "",
"type": "path",
"description": "Service version number. The current value is 2."
},
{
"name": "ext",
"value": "xml",
"type": "path",
"description": "Expected response format."
},
{
"name": "lat",
"value": "37.337",
"type": "query",
"description": "Latitude where results should be biased. \nNOTE: supplying a lat/lon without a radius will return search results biased to that point."
},
{
"name": "lon",
"value": "-121.89",
"type": "query",
"description": "Longitude where results should be biased\nNOTE: supplying a lat/lon without a radius will return search results biased to that point."
},
{
"name": "limit",
"value": "",
"type": "query",
"description": "Maximum number of search results that will be returned."
},
{
"name": "ofs",
"value": "",
"type": "query",
"description": "Starting offset of the returned results within the full result set."
},
{
"name": "countrySet",
"value": "FR",
"type": "query",
"description": "Comma separated string of country codes. This will limit the search to the specified countries."
},
{
"name": "radius",
"value": "",
"type": "query",
"description": "If radius and position are set, the results will be constrained to the defined area. The radius parameter is specified in meters."
},
{
"name": "topLeft",
"value": "37.553,-122.453",
"type": "query",
"description": "Top left position of the bounding box. This is specified as a comma separated string composed of lat., lon."
},
{
"name": "btmRight",
"value": "37.4,-122.55",
"type": "query",
"description": "Bottom right position of the bounding box. This is specified as a comma separated string composed of lat., lon."
},
{
"name": "language",
"value": "",
"type": "query",
"description": "Language in which search results should be returned. Should be one of supported IETF language tags, case insensitive."
},
{
"name": "extendedPostalCodesFor",
"value": "",
"type": "query",
"description": "Indexes for which extended postal codes should be included in the results. Available indexes are:\n - Addr = Address ranges\n - Geo = Geographies\n - PAD = Point Addresses\n - POI = Points of Interest\n - Str = Streets\n - XStr = Cross Streets (intersections)"
},
{
"name": "minFuzzyLevel",
"value": "",
"type": "query",
"description": "Minimum fuzziness level to be used."
},
{
"name": "maxFuzzyLevel",
"value": "",
"type": "query",
"description": "Maximum fuzziness level to be used."
},
{
"name": "idxSet",
"value": "POI",
"type": "query",
"description": "A comma separated list of indexes which should be utilized for the search. Item order does not matter. Available indexes are:\n - Addr = Address range interpolation (when there is no PAD)\n - Geo = Geographies\n - PAD = Point Addresses\n - POI = Points of interest\n - Str = Streets\n - Xstr = Cross Streets (intersections)"
},
{
"name": "view",
"value": "",
"type": "query",
"description": "Geopolitical View."
}
]
},
"docs": "Nearby Search"
},
{
"info": {
"name": "Points of Interest Search",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://api.tomtom.com/search/:versionNumber/poiSearch/:query.:ext",
"params": [
{
"name": "versionNumber",
"value": "",
"type": "path",
"description": "Service version number. The current value is 2."
},
{
"name": "query",
"value": "pizza",
"type": "path",
"description": "Query string. Must be properly URL encoded."
},
{
"name": "ext",
"value": "xml",
"type": "path",
"description": "Expected response format."
},
{
"name": "typeahead",
"value": "",
"type": "query",
"description": "If the \"typeahead\" flag is set, the query will be interpreted as a partial input and the search will enter predictive mode."
},
{
"name": "limit",
"value": "",
"type": "query",
"description": "Maximum number of search results that will be returned."
},
{
"name": "ofs",
"value": "",
"type": "query",
"description": "Starting offset of the returned results within the full result set."
},
{
"name": "countrySet",
"value": "FR",
"type": "query",
"description": "Comma separated string of country codes. This will limit the search to the specified countries."
},
{
"name": "lat",
"value": "37.337",
"type": "query",
"description": "Latitude where results should be biased. \nNOTE: supplying a lat/lon without a radius will return search results biased to that point."
},
{
"name": "lon",
"value": "-121.89",
"type": "query",
"description": "Longitude where results should be biased\nNOTE: supplying a lat/lon without a radius will return search results biased to that point."
},
{
"name": "radius",
"value": "",
"type": "query",
"description": "If radius and position are set, the results will be constrained to the defined area. The radius parameter is specified in meters."
},
{
"name": "topLeft",
"value": "37.553,-122.453",
"type": "query",
"description": "Top left position of the bounding box. This is specified as a comma separated string composed of lat., lon."
},
{
"name": "btmRight",
"value": "37.4,-122.55",
"type": "query",
"description": "Bottom right position of the bounding box. This is specified as a comma separated string composed of lat., lon."
},
{
"name": "language",
"value": "",
"type": "query",
"description": "Language in which search results should be returned. Should be one of supported IETF language tags, case insensitive."
},
{
"name": "extendedPostalCodesFor",
"value": "",
"type": "query",
"description": "Indexes for which extended postal codes should be included in the results. Available indexes are:\n - Addr = Address ranges\n - Geo = Geographies\n - PAD = Point Addresses\n - POI = Points of Interest\n - Str = Streets\n - XStr = Cross Streets (intersections)"
},
{
"name": "view",
"value": "",
"type": "query",
"description": "Geopolitical View."
}
]
},
"docs": "Points of Interest Search"
},
{
"info": {
"name": "Routed Search",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://api.tomtom.com/search/:versionNumber/routedSearch/:query/:position/:heading.:ext",
"params": [
{
"name": "versionNumber",
"value": "",
"type": "path",
"description": "Service version number. The current value is 2."
},
{
"name": "query",
"value": "gas",
"type": "path",
"description": "Query string. Must be properly URL encoded."
},
{
"name": "position",
"value": "37.8328,-122.27669",
"type": "path",
"description": "This is specified as a comma separated string composed of lat., lon."
},
{
"name": "heading",
"value": "90",
"type": "path",
"description": "The directional heading in degrees, usually similar to the course along a road segment. Entered in degrees, measured clockwise from north (so north is 0, east is 90, etc.)"
},
{
"name": "ext",
"value": "xml",
"type": "path",
"description": "Expected response format."
},
{
"name": "typeahead",
"value": "",
"type": "query",
"description": "If the \"typeahead\" flag is set, the query will be interpreted as a partial input and the search will enter predictive mode."
},
{
"name": "limit",
"value": "",
"type": "query",
"description": "Maximum number of search results that will be returned."
},
{
"name": "multiplier",
"value": "",
"type": "query",
"description": "Multiplies the limit by N to gather more candidate POIs, which will then be sorted by drive distance, returning only the top candidates according to the limit."
},
{
"name": "routingTimeout",
"value": "",
"type": "query",
"description": "Only return results that arrive from routing engine within this time limit."
},
{
"name": "language",
"value": "",
"type": "query",
"description": "Language in which search results should be returned. Should be one of supported IETF language tags, case insensitive."
},
{
"name": "extendedPostalCodesFor",
"value": "",
"type": "query",
"description": "Indexes for which extended postal codes should be included in the results. Available indexes are:\n - Addr = Address ranges\n - Geo = Geographies\n - PAD = Point Addresses\n - POI = Points of Interest\n - Str = Streets\n - XStr = Cross Streets (intersections)"
},
{
"name": "idxSet",
"value": "POI",
"type": "query",
"description": "A comma separated list of indexes which should be utilized for the search. Item order does not matter. Available indexes are:\n - Addr = Address range interpolation (when there is no PAD)\n - Geo = Geographies\n - PAD = Point Addresses\n - POI = Points of interest\n - Str = Streets\n - Xstr = Cross Streets (intersections)"
}
]
},
"docs": "Routed Search"
},
{
"info": {
"name": "Low Bandwith Search",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://api.tomtom.com/search/:versionNumber/s/:query.:ext",
"params": [
{
"name": "versionNumber",
"value": "",
"type": "path",
"description": "Service version number. The current value is 2."
},
{
"name": "query",
"value": "pizza",
"type": "path",
"description": "Query string. Must be properly URL encoded."
},
{
"name": "ext",
"value": "xml",
"type": "path",
"description": "Expected response format."
},
{
"name": "typeahead",
"value": "",
"type": "query",
"description": "If the \"typeahead\" flag is set, the query will be interpreted as a partial input and the search will enter predictive mode."
},
{
"name": "limit",
"value": "",
"type": "query",
"description": "Maximum number of search results that will be returned."
},
{
"name": "ofs",
"value": "",
"type": "query",
"description": "Starting offset of the returned results within the full result set."
},
{
"name": "countrySet",
"value": "FR",
"type": "query",
"description": "Comma separated string of country codes. This will limit the search to the specified countries."
},
{
"name": "lat",
"value": "37.337",
"type": "query",
"description": "Latitude where results should be biased. \nNOTE: supplying a lat/lon without a radius will return search results biased to that point."
},
{
"name": "lon",
"value": "-121.89",
"type": "query",
"description": "Longitude where results should be biased\nNOTE: supplying a lat/lon without a radius will return search results biased to that point."
},
{
"name": "radius",
"value": "",
"type": "query",
"description": "If radius and position are set, the results will be constrained to the defined area. The radius parameter is specified in meters."
},
{
"name": "topLeft",
"value": "37.553,-122.453",
"type": "query",
"description": "Top left position of the bounding box. This is specified as a comma separated string composed of lat., lon."
},
{
"name": "btmRight",
"value": "37.4,-122.55",
"type": "query",
"description": "Bottom right position of the bounding box. This is specified as a comma separated string composed of lat., lon."
},
{
"name": "language",
"value": "",
"type": "query",
"description": "Language in which search results should be returned. Should be one of supported IETF language tags, case insensitive."
},
{
"name": "idxSet",
"value": "POI",
"type": "query",
"description": "A comma separated list of indexes which should be utilized for the search. Item order does not matter. Available indexes are:\n - Addr = Address range interpolation (when there is no PAD)\n - Geo = Geographies\n - PAD = Point Addresses\n - POI = Points of interest\n - Str = Streets\n - Xstr = Cross Streets (intersections)"
},
{
"name": "view",
"value": "",
"type": "query",
"description": "Geopolitical View."
}
]
},
"docs": "Low Bandwith Search"
},
{
"info": {
"name": "Fuzzy Search",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://api.tomtom.com/search/:versionNumber/search/:query.:ext",
"params": [
{
"name": "versionNumber",
"value": "",
"type": "path",
"description": "Service version number. The current value is 2."
},
{
"name": "query",
"value": "pizza",
"type": "path",
"description": "Query string. Must be properly URL encoded.\n\nTo perform a reverse geocode, the user can provide latitude and longitude coordinates directly in the query. More information can be found here."
},
{
"name": "ext",
"value": "xml",
"type": "path",
"description": "Expected response format."
},
{
"name": "typeahead",
"value": "",
"type": "query",
"description": "If the \"typeahead\" flag is set, the query will be interpreted as a partial input and the search will enter predictive mode."
},
{
"name": "limit",
"value": "",
"type": "query",
"description": "Maximum number of search results that will be returned."
},
{
"name": "ofs",
"value": "",
"type": "query",
"description": "Starting offset of the returned results within the full result set."
},
{
"name": "countrySet",
"value": "FR",
"type": "query",
"description": "Comma separated string of country codes. This will limit the search to the specified countries."
},
{
"name": "lat",
"value": "37.337",
"type": "query",
"description": "Latitude where results should be biased. \nNOTE: supplying a lat/lon without a radius will return search results biased to that point."
},
{
"name": "lon",
"value": "-121.89",
"type": "query",
"description": "Longitude where results should be biased\nNOTE: supplying a lat/lon without a radius will return search results biased to that point."
},
{
"name": "radius",
"value": "",
"type": "query",
"description": "If radius and position are set, the results will be constrained to the defined area. The radius parameter is specified in meters."
},
{
"name": "topLeft",
"value": "37.553,-122.453",
"type": "query",
"description": "Top left position of the bounding box. This is specified as a comma separated string composed of lat., lon."
},
{
"name": "btmRight",
"value": "37.4,-122.55",
"type": "query",
"description": "Bottom right position of the bounding box. This is specified as a comma separated string composed of lat., lon."
},
{
"name": "language",
"value": "",
"type": "query",
"description": "Language in which search results should be returned. Should be one of supported IETF language tags, case insensitive."
},
{
"name": "extendedPostalCodesFor",
"value": "",
"type": "query",
"description": "Indexes for which extended postal codes should be included in the results. Available indexes are:\n - Addr = Address ranges\n - Geo = Geographies\n - PAD = Point Addresses\n - POI = Points of Interest\n - Str = Streets\n - XStr = Cross Streets (intersections)"
},
{
"name": "minFuzzyLevel",
"value": "",
"type": "query",
"description": "Minimum fuzziness level to be used."
},
{
"name": "maxFuzzyLevel",
"value": "",
"type": "query",
"description": "Maximum fuzziness level to be used."
},
{
"name": "idxSet",
"value": "POI",
"type": "query",
"description": "A comma separated list of indexes which should be utilized for the search. Item order does not matter. Available indexes are:\n - Addr = Address range interpolation (when there is no PAD)\n - Geo = Geographies\n - PAD = Point Addresses\n - POI = Points of interest\n - Str = Streets\n - Xstr = Cross Streets (intersections)"
},
{
"name": "view",
"value": "",
"type": "query",
"description": "Geopolitical View."
}
]
},
"docs": "Fuzzy Search"
},
{
"info": {
"name": "Along Route Search",
"type": "http"
},
"http": {
"method": "POST",
"url": "https://api.tomtom.com/search/:versionNumber/searchAlongRoute/:query.:ext",
"params": [
{
"name": "versionNumber",
"value": "",
"type": "path",
"description": "Service version number. The current value is 2."
},
{
"name": "query",
"value": "pizza",
"type": "path",
"description": "Query string. Must be properly URL encoded."
},
{
"name": "ext",
"value": "xml",
"type": "path",
"description": "Expected response format."
},
{
"name": "maxDetourTime",
"value": "1200",
"type": "query",
"description": "Maximum detour time"
},
{
"name": "limit",
"value": "",
"type": "query",
"description": "Maximum number of search results that will be returned."
}
],
"body": {
"type": "json",
"data": "{}"
}
},
"docs": "Along Route Search"
}
]
}
],
"bundled": true
}