Characteristic
Short description
Country codes specify countries and principal subdivisions of countries.
Use
The xRuntime service provides the getDataInformation operation, which returns information about the regions that are available in the installed map. A region is either a country or a principal subdivision of a country specified by a country code.
In the xRoute service country codes are used to specify the countries for certain entities of a route
A route corresponds to a path of a vehicle through the underlying transport network. The main attributes of a route are the distance and the time that the vehicle travels along the path., e.g., the country of a waypoint.
In the xRoute and xDima requests country codes can be used to geographically restrict the search space of the routing algorithm.
In the xMap requests country codes can be used in a country list to define country-dependent styles.
Detailed Consideration
ISO 3166
We use ISO 3166-1 alpha-2 codes to specify countries, and ISO 3166-2 codes for principal subdivisions of countries. The principal subdivisions are available only for some large countries such as the United States, Canada, and Australia. There are some dependent territories which have both an ISO 3166-1 alpha-2 country code and an ISO 3166-2 subdivision code of another country.
Examples:
- DE specifies Germany (ISO 3166-1 alpha-2)
- US-FL specifies Florida as principal subdivision of the United States (ISO 3166-2)
- PR and US-PR both specify Puerto Rico
- RE and FR-RE both specify Réunion
PTV Continent Codes
We use the reserved ISO 3166-1 alpha-2 code ZZ as prefix to define continent codes in analogy to ISO 3166-2 principal subdivisions of the world. Note that these continent codes are not standardized. The assignment of countries to continents is PTV-specific and can be different for each map.
| Continent | Continent Code |
|---|---|
| Africa | ZZ-AFR |
| Asia | ZZ-ASI |
| Antarctica | ZZ-ATA |
| Australia | ZZ-AUS |
| Europe | ZZ-EUR |
| North America | ZZ-NAM |
| South America | ZZ-SAM |
Country Code Type
The fields of profiles A profile is a collection of parameters used to configure the request. Full profiles consist of a number of specialized sub-profiles like the VehicleProfile which describes the properties of a vehicle., requests, and responses that contain country codes are using the type CountryCode. In requests it can be any of the above mentioned representations (e.g., US-FL for Florida, US for all of the United States, ZZ-NAM for all of North America). The response is ISO 3166-2 if available (e.g., US-FL), ISO 3166-1 otherwise (e.g., DE).
Related Topics
| Technical Concept | Geocoding: ISO 3166-1 alpha-2 codes can be used also to specify the country of an address. |