MENU
      Reverse Geocoding API

        Reverse Geocoding API


        Article summary

        Available in VPC

        Convert the entered coordinate values to address information (statutory dong, administrative dong, administrative building, land-lot name address, road name address).

        Note

        The Reverse Geocoding API supports some coordinate systems specified by the European Petroleum Survey Group (EPSG), as well as coordinate systems commonly used in Korea. For more information about the supported coordinate systems, see Coordinate system

        Request

        The following describes the request format for the endpoint. The request format is as follows:

        MethodURI
        GET/gc

        Request headers

        For headers common to all Maps APIs, see Common Maps headers.

        Request query parameters

        The following describes the request query parameters.

        FieldTypeRequiredDescription
        coordsStringRequiredCoordinates (X coordinate,Y coordinate)
        • <e.g.> coords=128.12345,37.98776
        sourcecrsStringOptionalInput coordinate system code
        • EPSG:4326 (default) | EPSG:3857 | NHN:2048
          • EPSG:4326: WGS84 longitude and latitude
          • EPSG:3857: Google Maps
          • NHN:2048: UTM-K
        • For more information about the supported coordinate systems, see Coordinate system
        targetcrsStringOptionalOutput coordinate system code
        • EPSG:4326 (default) | EPSG:3857 | NHN:2048
          • EPSG:4326: WGS84 longitude and latitude
          • EPSG:3857: Google Maps
          • NHN:2048: UTM-K
        • For more information about the supported coordinate systems, see Coordinate system
        ordersStringOptionalConversion type
        • legalcode (default) | admcode (default) | addr | roadaddr
          • legalcode: Convert to statutory dong
          • admcode: Convert to administrative dong
          • addr: Convert to land-lot name address
          • roadaddr: Convert to road name address
        • Multiple option values can be entered separated by "," and results are displayed in the order of entry
        • When converting coordinates for areas without detailed addresses, such as near coastlines or in new neighborhoods, requests with addr or roadaddr may not return results, but requests with legalcode or admcode can resolve addresses by statutory or administrative dong
        • <e.g.> orders=legalcode,addr
        outputStringOptionalFormat type of the response result
        • xml (default) | json
        callbackStringOptionalCallback name
        • Use when processing callbacks for JSONP communication
        • Return JSON data wrapped in the entered name
        • Can only be entered if output is json
        • <e.g.> callback=abc

        Coordinate system

        The following describes the coordinate system.

        NameCodeTypeGCS informationPCS information
        Google MapsEPSG:3857PCSWGS_1984WGS_19846378137 (Semi_Minor)298.2572236GreenwichDegreeM0000Meter1
        WGS 84 longitude and latitudeEPSG:4326GCSWGS_1984WGS_19846378137298.2572236GreenwichDegree-------
        UTM-KNHN:2048PCSD_ITRF_2000GRS_19806378137298.2572221GreenwichDegreeTM127.5382,000,0001,000,000Meter0.9996

        Request example

        The following is a sample request.

        curl --location --request GET 'https://naveropenapi.apigw.ntruss.com/map-reversegeocode/v2/gc?coords=127.585%2C34.9765&output=json&orders=legalcode%2Cadmcode%2Caddr%2Croadaddr' \
        --header 'x-ncp-apigw-api-key-id: {API Key ID}' \
        --header 'x-ncp-apigw-api-key: {API Key}'
        Shell
        Note

        Depending on the coordinates you enter, different response results can be returned. See the following example requests.

        • General eup/myeon/dong
          • https://naveropenapi.apigw.ntruss.com/map-reversegeocode/v2/gc?request=coordsToaddr&coords=126.9913201,37.5666936&sourcecrs=epsg:4326&orders=admcode,legalcode,addr,roadaddr&output=xml
          • https://naveropenapi.apigw.ntruss.com/map-reversegeocode/v2/gc?request=coordsToaddr&coords=129.1133567,35.2982640&sourcecrs=epsg:4326&orders=admcode,legalcode,addr,roadaddr&output=xml
        • General ri: Coordinates in ri subdivisions of eup/myeon, which are statutory dong units, show codeType as L even in admcode results.
          • https://naveropenapi.apigw.ntruss.com/map-reversegeocode/v2/gc?request=coordsToaddr&coords=128.2439084,36.4938906&sourcecrs=epsg:4326&orders=admcode,legalcode,addr,roadaddr&output=xml
        • If an administrative dong exists with the same name as a statutory dong but in a different area
          • https://naveropenapi.apigw.ntruss.com/map-reversegeocode/v2/gc?request=coordsToaddr&coords=127.1114893,37.3614463&sourcecrs=epsg:4326&orders=admcode,legalcode,addr,roadaddr&output=xml
        • Sejong-si: No data exists for the si/gun/gu, and the statutory dong of all subordinate administrative dong is displayed the same, although the areas are different.
          • Eojin-dong, Sejong-si: https://naveropenapi.apigw.ntruss.com/map-reversegeocode/v2/gc?request=coordsToaddr&coords=127.2654387,36.5008113&sourcecrs=epsg:4326&orders=admcode,legalcode,addr,roadaddr&output=xm
          • Jochiwon-eup, Sejong-si: https://naveropenapi.apigw.ntruss.com/map-reversegeocode/v2/gc?request=coordsToaddr&coords=127.2923750,36.5929071&sourcecrs=epsg:4326&orders=admcode,legalcode,addr,roadaddr&output=xml
        • Coordinates over sea: No response results displayed.
          • https://naveropenapi.apigw.ntruss.com/map-reversegeocode/v2/gc?request=coordsToaddr&coords=125.9913201,37.5666936&sourcecrs=epsg:4326&orders=admcode,legalcode,addr,roadaddr&output=xml

        Response

        The following describes the response format.

        Response body

        The following describes the response body.

        FieldTypeRequiredDescription
        statusObject-Information about response status
        status.codeInteger-Response status codes
        status.nameString-Response status message
        status.messageString-Description of response status
        resultsArray-Response result

        results

        The following describes results.

        FieldTypeRequiredDescription
        nameString-Conversion type
        codeObject-Code information
        code.idString-Code ID
        code.typeString-Code type
        • L | A | S
          • L: statutory dong
          • A: administrative dong
          • S: administrative dong with the same name as a statutory dong but in a different area
        code.mappingIdString-ID of NAVER dong code mapped to statutory/administrative code
        regionObject-Address information
        region.areaNObject-Administrative area information
        • Display converted addresses sequentially, starting with the largest administrative unit
        region.areaN.nameString-Administrative area unit name
        • region.area0.name: country code top-level domain, displaying kr
        • region.area1.name: name of si/do as published by the Ministry of the Interior and Safety
        • region.area2.name: name of si/gun/gu as published by the Ministry of the Interior and Safety
        • region.area3.name: name of eup/myeon/dong as published by the Ministry of the Interior and Safety
        • region.area4.name: name of ri as published by the Ministry of the Interior and Safety
        region.areaN.coordsObject-Administrative area location information
        region.areaN.coords.centerObject-Administrative area center coordinates
        region.areaN.coords.center.crsString-Coordinate system code
        region.areaN.coords.center.xFloat-X coordinates
        • If land.coords.center.crs is EPSG:4326, longitude
        region.areaN.coords.center.yFloat-Y coordinates
        • If land.coords.center.crs is EPSG:4326, latitude
        landObject-Detailed address information
        land.typeString-Cadastral type
        • Display the detailed value only if name is addr
        • 1 | 2
          • 1: general land
          • 2: mountain
        land.nameString-Road name
        • Display the detailed value only if name is roadaddr
        land.number1String-Detailed number
        • If name is addr, land original number
        • If name is roadaddr, detailed address
        land.number2String-Land sub name
        • Display the detailed value only if name is addr
        land.coordsObject-Detailed address location information
        land.coords.centerObject-Detailed address center coordinates
        land.coords.center.crsString-Coordinate system code
        land.coords.center.xFloat-X coordinates
        • If land.coords.center.crs is EPSG:4326, longitude
        land.coords.center.yFloat-Y coordinates
        • If land.coords.center.crs is EPSG:4326, latitude
        land.additionNObject-Additional information
        • Display the detailed value only if name is roadaddr
        • land.addition0: building information
        • land.addition1: postal code information
        • land.addition2: road code information
        land.additionN.typeString-Additional Information type
        • land.addition0.type: building
        • land.addition1.type: zipcode
        • land.addition2.type: roadGroupCode
        land.additionN.valueString-Additional information value
        • land.addition0.value: building name
        • land.addition1.value: postal code
        • land.addition2.value: road code (12 digits)

        Response status codes

        The following describes the response status codes.

        HTTP status codeCodeMessageDescription
        2000okRequest processing successful. Return response result
        2003no resultsRequest processing successful. Response result not returned
        400100invalid requestRequest parameter error
        500900unknown error / io errorUndefined error
        Note

        For response status codes common to all Maps APIs, see Common Maps response status codes.

        Response example

        The following is a sample example.

        {
            "status": {
                "code": 0,
                "name": "ok",
                "message": "done"
            },
            "results": [
                {
                    "name": "legalcode",
                    "code": {
                        "id": "4623025024",
                        "type": "L",
                        "mappingId": "1223025024"
                    },
                    "region": {
                        "area0": {
                            "name": "kr",
                            "coords": {
                                "center": {
                                    "crs": "",
                                    "x": 0.0,
                                    "y": 0.0
                                }
                            }
                        },
                        "area1": {
                            "name": "Jeollanam-do",
                            "coords": {
                                "center": {
                                    "crs": "EPSG:4326",
                                    "x": 126.957167,
                                    "y": 34.900727
                                }
                            },
                            "alias": "Jeonnam"
                        },
                        "area2": {
                            "name": "Gwangyang-si",
                            "coords": {
                                "center": {
                                    "crs": "EPSG:4326",
                                    "x": 127.695899,
                                    "y": 34.940658
                                }
                            }
                        },
                        "area3": {
                            "name": "Gwangyang-eup",
                            "coords": {
                                "center": {
                                    "crs": "EPSG:4326",
                                    "x": 127.58105,
                                    "y": 34.97341
                                }
                            }
                        },
                        "area4": {
                            "name": "Eupnae-ri",
                            "coords": {
                                "center": {
                                    "crs": "EPSG:4326",
                                    "x": 127.5863,
                                    "y": 34.9751
                                }
                            }
                        }
                    }
                },
                {
                    "name": "admcode",
                    "code": {
                        "id": "4623025000",
                        "type": "L",
                        "mappingId": "12230250"
                    },
                    "region": {
                        "area0": {
                            "name": "kr",
                            "coords": {
                                "center": {
                                    "crs": "",
                                    "x": 0.0,
                                    "y": 0.0
                                }
                            }
                        },
                        "area1": {
                            "name": "Jeollanam-do",
                            "coords": {
                                "center": {
                                    "crs": "EPSG:4326",
                                    "x": 126.957167,
                                    "y": 34.900727
                                }
                            },
                            "alias": "Jeonnam"
                        },
                        "area2": {
                            "name": "Gwangyang-si",
                            "coords": {
                                "center": {
                                    "crs": "EPSG:4326",
                                    "x": 127.695899,
                                    "y": 34.940658
                                }
                            }
                        },
                        "area3": {
                            "name": "Gwangyang-eup",
                            "coords": {
                                "center": {
                                    "crs": "EPSG:4326",
                                    "x": 127.58105,
                                    "y": 34.97341
                                }
                            }
                        },
                        "area4": {
                            "name": "",
                            "coords": {
                                "center": {
                                    "crs": "",
                                    "x": 0.0,
                                    "y": 0.0
                                }
                            }
                        }
                    }
                },
                {
                    "name": "addr",
                    "code": {
                        "id": "4623025024",
                        "type": "L",
                        "mappingId": "1223025024"
                    },
                    "region": {
                        "area0": {
                            "name": "kr",
                            "coords": {
                                "center": {
                                    "crs": "",
                                    "x": 0.0,
                                    "y": 0.0
                                }
                            }
                        },
                        "area1": {
                            "name": "Jeollanam-do",
                            "coords": {
                                "center": {
                                    "crs": "EPSG:4326",
                                    "x": 126.957167,
                                    "y": 34.900727
                                }
                            },
                            "alias": "Jeonnam"
                        },
                        "area2": {
                            "name": "Gwangyang-si",
                            "coords": {
                                "center": {
                                    "crs": "EPSG:4326",
                                    "x": 127.695899,
                                    "y": 34.940658
                                }
                            }
                        },
                        "area3": {
                            "name": "Gwangyang-eup",
                            "coords": {
                                "center": {
                                    "crs": "EPSG:4326",
                                    "x": 127.58105,
                                    "y": 34.97341
                                }
                            }
                        },
                        "area4": {
                            "name": "Eupnae-ri",
                            "coords": {
                                "center": {
                                    "crs": "EPSG:4326",
                                    "x": 127.5863,
                                    "y": 34.9751
                                }
                            }
                        }
                    },
                    "land": {
                        "type": "1",
                        "number1": "252",
                        "number2": "1",
                        "addition0": {
                            "type": "",
                            "value": ""
                        },
                        "addition1": {
                            "type": "",
                            "value": ""
                        },
                        "addition2": {
                            "type": "",
                            "value": ""
                        },
                        "addition3": {
                            "type": "",
                            "value": ""
                        },
                        "addition4": {
                            "type": "",
                            "value": ""
                        },
                        "coords": {
                            "center": {
                                "crs": "",
                                "x": 0.0,
                                "y": 0.0
                            }
                        }
                    }
                },
                {
                    "name": "roadaddr",
                    "code": {
                        "id": "4623025024",
                        "type": "L",
                        "mappingId": "1223025024"
                    },
                    "region": {
                        "area0": {
                            "name": "kr",
                            "coords": {
                                "center": {
                                    "crs": "",
                                    "x": 0.0,
                                    "y": 0.0
                                }
                            }
                        },
                        "area1": {
                            "name": "Jeollanam-do",
                            "coords": {
                                "center": {
                                    "crs": "EPSG:4326",
                                    "x": 126.957167,
                                    "y": 34.900727
                                }
                            },
                            "alias": "Jeonnam"
                        },
                        "area2": {
                            "name": "Gwangyang-si",
                            "coords": {
                                "center": {
                                    "crs": "EPSG:4326",
                                    "x": 127.695899,
                                    "y": 34.940658
                                }
                            }
                        },
                        "area3": {
                            "name": "Gwangyang-eup",
                            "coords": {
                                "center": {
                                    "crs": "EPSG:4326",
                                    "x": 127.58105,
                                    "y": 34.97341
                                }
                            }
                        },
                        "area4": {
                            "name": "Eupnae-ri",
                            "coords": {
                                "center": {
                                    "crs": "EPSG:4326",
                                    "x": 127.5863,
                                    "y": 34.9751
                                }
                            }
                        }
                    },
                    "land": {
                        "type": "",
                        "number1": "20",
                        "number2": "",
                        "addition0": {
                            "type": "building",
                            "value": ""
                        },
                        "addition1": {
                            "type": "zipcode",
                            "value": "57742"
                        },
                        "addition2": {
                            "type": "roadGroupCode",
                            "value": "462304655159"
                        },
                        "addition3": {
                            "type": "",
                            "value": ""
                        },
                        "addition4": {
                            "type": "",
                            "value": ""
                        },
                        "name": "Maeilsijang-gil",
                        "coords": {
                            "center": {
                                "crs": "",
                                "x": 0.0,
                                "y": 0.0
                            }
                        }
                    }
                }
            ]
        }
        JSON

        Was this article helpful?

        Changing your password will log you out immediately. Use the new password to log back in.
        First name must have atleast 2 characters. Numbers and special characters are not allowed.
        Last name must have atleast 1 characters. Numbers and special characters are not allowed.
        Enter a valid email
        Enter a valid password
        Your profile has been successfully updated.