Developer

Region-specific content

Last edit: 2025.04.22

Some parts of TomTom data are subject to additional legal terms and conditions. When used, the customer must agree to and follow these additional conditions. Also, for some regions our APIs can have differences in requests and responses compared to the default API behavior. Customers should be aware of these differences before using the region-specific content.

Available region-specific contents

Hostname

Description

kr-api.tomtom.com

  • Hostname, where detailed South Korea data is available.

  • Detailed South Korean data is processed and hosted in South Korea.

    • It may impact the latency for requests sent from outside of South Korea.

  • The service customers are not allowed to download, store, cache nor host the South Korean data outside of South Korea (except for web browser cache).

  • The service customers are not allowed to display any coordinates of any place within South Korea.

  • Response data for South Korea can have additional response data.

Region-specific API changes

Response data for South Korea

South Korea switched from a land lot-based addressing format to a street name-based format in 2011. At this moment land lot-based addressing format is not supported by the TomTom Orbis Reverse Geocoding API. The API response will contain only the street name-based address.

Street name-based address only

For a Point Address with only a street name-based address, the API response is identical to the default API response.

Example response for the result of the Point Address type is in the following format:

Point Address type example response - JSON
1{
2  "summary": {
3    "queryTime": 15,
4    "numResults": 1
5  },
6  "addresses": [
7    {
8      "address": {
9        "buildingNumber": "116",
10        "streetNumber": "116",
11        "routeNumbers": [],
12        "street": "석산로",
13        "streetName": "석산로",
14        "streetNameAndNumber": "석산로 116",
15        "countryCode": "KR",
16        "countrySubdivision": "경기도",
17        "municipality": "양평군",
18        "postalCode": "12528",
19        "municipalitySubdivision": "단월면",
20        "municipalitySecondarySubdivision": "향소리",
21        "country": "대한민국",
22        "countryCodeISO3": "KOR",
23        "freeformAddress": "12528 경기도 양평군 석산로 116 단월면",
24        "boundingBox": {
25          "northEast": "37.564099,127.663347",
26          "southWest": "37.561331,127.659166",
27          "entity": "position"
28        },
29        "countrySubdivisionName": "경기도",
30        "countrySubdivisionCode": "41",
31        "localName": "단월면"
32      },
33      "position": "37.562229,127.661736",
34      "matchType": "AddressPoint",
35      "mapcodes": [
36        {
37          "type": "Local",
38          "fullMapcode": "KOR 두5.1럐",
39          "territory": "KOR",
40          "code": "두5.1럐"
41        },
42        {
43          "type": "International",
44          "fullMapcode": "ᅩᄌ533.1ᄇᄎ3ᄂ"
45        },
46        {
47          "type": "Alternative",
48          "fullMapcode": "KOR ᄇ59.ᅭᅩ6ᄐᄑ",
49          "territory": "KOR",
50          "code": "ᄇ59.ᅭᅩ6ᄐᄑ"
51        }
52      ],
53      "id": "bbKIrNNVe3IVu2crK7UijA"
54    }
55  ]
56}

Example response for the Geography result with entityType=PostalCodeArea filtering:

Geography example response - JSON
1{
2  "summary": {
3    "queryTime": 15,
4    "numResults": 1
5  },
6  "addresses": [
7    {
8      "address": {
9        "routeNumbers": [],
10        "countryCode": "KR",
11        "countrySubdivision": "경기도",
12        "municipality": "양평군",
13        "postalCode": "12528",
14        "municipalitySubdivision": "단월면",
15        "municipalitySecondarySubdivision": "향소리",
16        "country": "대한민국",
17        "countryCodeISO3": "KOR",
18        "freeformAddress": "12528 경기도 양평군",
19        "boundingBox": {
20          "northEast": "37.601256,127.694382",
21          "southWest": "37.539180,127.610146",
22          "entity": "position"
23        },
24        "countrySubdivisionName": "경기도",
25        "countrySubdivisionCode": "41"
26      },
27      "position": "37.562267,127.661674",
28      "dataSources": {
29        "geometry": {
30          "id": "4772724793"
31        }
32      },
33      "entityType": "PostalCodeArea",
34      "mapcodes": [
35        {
36          "type": "Local",
37          "fullMapcode": "KOR 두5.1다",
38          "territory": "KOR",
39          "code": "두5.1다"
40        },
41        {
42          "type": "International",
43          "fullMapcode": "ᅩᄌ533.1ᄇᄎ2ᄀ"
44        },
45        {
46          "type": "Alternative",
47          "fullMapcode": "KOR ᄇ59.ᅭᅩ6ᄅᄏ",
48          "territory": "KOR",
49          "code": "ᄇ59.ᅭᅩ6ᄅᄏ"
50        }
51      ],
52      "id": "4772724793"
53    }
54  ]
55}