Copyrights
Service version: 1
Last edit: 2020.02.05
On this page
Purpose
The Copyrights API is designed to serve copyright information for the Maps Raster Tile service. In addition to basic copyright for the whole map, this API is serving specific groups of copyrights for some countries which are written in JSON, JSONP, or XML formats.
Run this endpoint
You can easily run this and other endpoints.
- Go to the TomTom API Explorer page.
- Click an endpoint.
- Click Try it out.
- Enter/select all required parameter values and any optional parameter values.
- At the bottom of the form, click Execute.
- Review the Response.
Request data
The user may request copyright information for three contexts: for a specific tile, for a stated bounding box, or for the whole world.
- Tile
- To obtain the copyright information for a particular tile, the Request should specify the tile's zoom level and x and y coordinates. See the: Zoom Levels and Tile Grid page.
- Bounding box
- Bounding box requests should specify the minimum and maximum
longitude
andlatitude
(EPSG-3857) coordinates. - Whole world
- To obtain the default copyright information for the whole world, do not specify a tile or bounding box.
Schema
The generic copyrights call schemas are as follows.
- Required constants and parameters are shown in bold text.
- Optional parameters are shown in plain text.
Whole world
In the following Whole world Request, the format
parameter is required.
http|https://baseURL/map/versionNumber/copyrights.format?key=*****
Tile
In the following Tile Request, the zoom
, X
, and Y
parameters are required.
http|https://baseURL/map/versionNumber/copyrights/zoom/X/Y.format?key=*****
Bounding box
In the following Bounding box Request, the minLon
, minLat
, maxLon
, and maxLat
parameters are required.
http|https://baseURL/map/versionNumber/copyrights/minLon/minLat/maxLon/maxLat.format?key=*****
HTTPS method: GET
URL format
For ease of viewing and identification:
- Required constants and parameters are shown in bold text.
- Optional parameters are shown in plain text.
https://baseURL/map/versionNumber/copyrights/minLon/minLat/maxLon/maxLat.format?key=*****
curl command
curl -XGET 'https://baseURL/map/versionNumber/copyrights/minLon/minLat/maxLon/maxLat.format?key=*****'
Request parameters
These elements are used in calls to generate files with copyrights.
Required parameters | |
---|---|
Parameter | Description |
baseURL string |
The base URL for calling TomTom services. Value: api.tomtom.com |
versionNumber integer |
The version of the service to call. Value: The current version is 1 . |
key string |
An API Key valid for the requested service. Value: Your valid API Key. |
Optional parameters | |
Parameter | Description |
zoom integer |
Zoom level of the tile to be rendered. Only used for tile-level copyright calls. Value: 0..22 |
X integer |
The X coordinate of the tile on zoom grid. Only used for tile-level copyright calls. Value: 0..2 zoom -1 |
Y integer |
The Y coordinate of the tile on zoom grid. Only used for tile-level copyright calls. Value: 0..2 zoom -1 |
minLon float |
The minimum longitude coordinate of bounding box in a latitude longitude coordinate system. Only used for bounding box copyright calls. Value: -180..180 |
minLat float |
The minimum latitude coordinate of bounding box in a latitude longitude coordinate system. Only used for bounding box copyright calls. Value: -90..90 |
maxLon float |
The maximum longitude coordinate of bounding box in a latitude longitude coordinate system. Only used for bounding box copyright calls. Value: -180..180 |
maxLat float |
The maximum latitude coordinate of bounding box in a latitude longitude coordinate system. Only used for bounding box copyright calls. Value: -90..90 |
format string |
Format of the response. Note that this is required when doing a whole world call. Default value: xml Other values:
|
text boolean |
A boolean to exclude textual data from the Response. Only images and country names will be in the Response. Default value: yes Other value: no |
Examples
To get the global copyrights in JSON format:
https://api.tomtom.com/map/1/copyrights.json?key=*****
To get copyrights in JSONP format for Albuquerque in the United States, using tile coordinate parameters:
https://api.tomtom.com/map/1/copyrights/8/48/102.jsonp?key=*****
To get copyrights in XML format for Albuquerque in the United States, using bounding box parameters:
https://api.tomtom.com/map/1/copyrights/-106.8224/34.9246/-106.4008/35.3234.xml?key=*****
Response data
For each Request, the Copyrights API returns a file in JSON, JSONP or XML format that contains all copyrights for the specified area, ordered by country code (ISO3). The file contains the copyright applied to all countries (generalCopyrights) and any separate ones for the specific region requested.
Where a map data provider provides copyright information in the form of an image file, it will be returned in base64 format for presentation as an embedded picture.
The following is an example code embedding a base64 picture in the HTML page:
<html>
<body>
<img src="data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEA3ADcAAD/(...)//Z" />
</body>
</html>
Example JSON file:
{
"formatVersion": "0.0.1",
"generalCopyrights": [
"\u00a9 1992 \u2013 2019 TomTom. All rights reserved. This material is proprietary and the subject of copyright protection, database right protection and other intellectual property rights owned by TomTom or its suppliers. The use of this material is subject to the terms of a license agreement. Any unauthorized copying or disclosure of this material will lead to criminal and civil liabilities.",
"Data Source \u00a9 2019 TomTom"
],
"regions": [
{
"copyrights": [
"The following copyright notice applies to the use of Points of Interest: \u00A9 2006 \u2013 2018 TomTom. All rights reserved. Portions of the POI database contained in Points of Interest North America have been provided by Neustar Localeze",
"The following copyright notice applies to the use of Telecommunications: \u00A9 2017 Pitney Bowes. All rights reserved. In addition, for the following product layers Wire Center Boundaries, ILEC Boundaries, and Rate Center Boundaries, the following also applies: This product contains information and\/or data of Telcordia Technologies, Inc. (Telcordia) licensed to be included herein.",
"The following copyright notice applies to the use of TomTom Traffic: Portions of the data have been provided by Total Traffic & Weather Network, a division of iHeartMedia + Entertainment, Inc. \u00A9 2017. Total Traffic & Weather Network, a division of iHeartMedia + Entertainment, Inc. All rights reserved.",
"\u00A9 United States Postal Service 2017",
"Contains data made available by the Rhode Island Geographic Information System (RIGIS) consortium, the State of Rhode Island, and the University of Rhode Island. For specifics, please reference: http:\/\/www.rigis.org\/information"
"Contains Address Points data made available by State of Maryland and MD iMAP. For specifics, please reference: http:\/\/imap.maryland.gov."
],
"country": {
"ISO3": "USA",
"label": "United States"
},
}
]
}
Example JSONP file:
({
"formatVersion": "0.0.1",
"generalCopyrights": [
"\u00a9 1992 \u2013 2019 TomTom. All rights reserved. This material is proprietary and the subject of copyright protection, database right protection and other intellectual property rights owned by TomTom or its suppliers. The use of this material is subject to the terms of a license agreement. Any unauthorized copying or disclosure of this material will lead to criminal and civil liabilities.",
"Data Source \u00a9 2019 TomTom"
"based on"
],
"regions": [
{
"copyrights": [
"The following copyright notice applies to the use of Points of Interest: \u00A9 2006 \u2013 2018 TomTom. All rights reserved. Portions of the POI database contained in Points of Interest North America have been provided by Neustar Localeze",
"The following copyright notice applies to the use of Telecommunications: \u00A9 2017 Pitney Bowes. All rights reserved. In addition, for the following product layers Wire Center Boundaries, ILEC Boundaries, and Rate Center Boundaries, the following also applies: This product contains information and\/or data of Telcordia Technologies, Inc. (Telcordia) licensed to be included herein.",
"The following copyright notice applies to the use of TomTom Traffic: Portions of the data have been provided by Total Traffic & Weather Network, a division of iHeartMedia + Entertainment, Inc. \u00A9 2017. Total Traffic & Weather Network, a division of iHeartMedia + Entertainment, Inc. All rights reserved.",
"\u00A9 United States Postal Service 2017",
"Contains data made available by the Rhode Island Geographic Information System (RIGIS) consortium, the State of Rhode Island, and the University of Rhode Island. For specifics, please reference: http:\/\/www.rigis.org\/information"
"Contains Address Points data made available by State of Maryland and MD iMAP. For specifics, please reference: http:\/\/imap.maryland.gov."
],
"country": {
"ISO3": "USA",
"label": "United States"
}
}
]
});
Example XML file:
<copyrightsResponse xmlns="http://api.tomtom.com/map/1/copyrights" formatVersion="0.0.1">
<generalCopyrights>
<copyright>
© 1992 – 2015 TomTom. All rights reserved. This material is proprietary and the subject of copyright protection, database right protection and other intellectual property rights owned by TomTom or its suppliers. The use of this material is subject to the terms of a license agreement. Any unauthorized copying or disclosure of this material will lead to criminal and civil liabilities.
</copyright>
<copyright>
Data Source © 2015 TomTom
</copyright>
</generalCopyrights>
<regions>
<region>
<country>
<ISO3>
USA
</ISO3>
<label>
United States
</label>
</country>
<copyrights>
<copyright>
The following copyright notice applies to the use of Points of Interest: © 2006 – 2018 TomTom. All rights reserved. Portions of the POI database contained in Points of Interest North America have been provided by Neustar Localeze
</copyright>
<copyright>
The following copyright notice applies to the use of Telecommunications: © 2017 Pitney Bowes. All rights reserved. In addition, for the following product layers Wire Center Boundaries, ILEC Boundaries, and Rate Center Boundaries, the following also applies: This product contains information and/or data of Telcordia Technologies, Inc. (Telcordia) licensed to be included herein.
</copyright>
<copyright>
The following copyright notice applies to the use of TomTom Traffic: Portions of the data have been provided by Total Traffic & Weather Network, a division of iHeartMedia + Entertainment, Inc. © 2017. Total Traffic & Weather Network, a division of iHeartMedia + Entertainment, Inc. All rights reserved.
</copyright>
<copyright>
© United States Postal Service 2017
</copyright>
<copyright>
Contains data made available by the Rhode Island Geographic Information System (RIGIS) consortium, the State of Rhode Island, and the University of Rhode Island. For specifics, please reference: http://www.rigis.org/information
</copyright>
<copyright>
Contains Address Points data made available by State of Maryland and MD iMAP. For specifics, please reference: http://imap.maryland.gov.
</copyright>
</copyrights>
</region>
</regions>
</copyrightsResponse>
Country names and images request
Optionally, you can get a Response with only a list of countries and images without their copyright text. To achieve this, the text=no
parameter has to be added to the Request.
To get copyrights with only country names and images in JSONP format for Albuquerque in United States, using tile coordinate parameters:
http://api.tomtom.com/map/1/copyrights/8/48/102.jsonp?text=no&key=*****
Example JSON file:
{
"formatVersion": "0.0.1",
"regions": [
{
"country": {
"ISO3": "USA"
}
}
]
}
Captions request
As an alternative to copyrights for map Request, you can receive copyrights for the map service.
To get captions in XML:
http://api.tomtom.com/map/1/copyrights/caption.xml?key=*****
To get captions in JSON:
http://api.tomtom.com/map/1/copyrights/caption.json?key=*****
To get captions in JSONP:
http://api.tomtom.com/map/1/copyrights/caption.jsonp?key=*****
XML Response
<copyrightsCaptionResponse formatVersion="0.0.1" xmlns="http://api.tomtom.com/map/1/copyrights/caption">
<copyrightsCaption>© 1992 - 2019 TomTom.</copyrightsCaption>
</copyrightsCaptionResponse>
JSON Response
{
"formatVersion": "0.0.1",
"copyrightsCaption": "\u00a9 1992 - 2019 TomTom."
}
JSONP Response
({
"formatVersion": "0.0.1",
"copyrightsCaption": "\u00a9 1992 - 2019 TomTom."
});
HTTP Response codes
Code | Meaning and Possible Causes |
---|---|
200 |
OK |
304 |
Not Modified |
400 |
Malformed request: Malformed syntax. Possible causes include: Requested syntax is not available. |
400 |
Bad request: Parameters out of range. Possible causes include:
|
403 |
Forbidden: The supplied API Key is not valid for this Request. |
410 |
Gone: Request for unsupported format. |
429 |
Too Many Requests: Too many requests were sent in a given amount of time for the supplied API Key. |
500 |
Internal Server Error: There is a problem with the TomTom Copyrights API service. |
HTTP Response headers
Header | Description |
---|---|
Access-Control-Allow-Origin |
The Maps Copyrights API allows cross-origin resource sharing (CORS). Value: * |
ETag |
The Maps Copyrights API provides ETag and supports the If-None-Match header.Value: * |