Login
      目次 x
      Reverse Geocoding API
        • 印刷する
        • PDF
        目次

        Reverse Geocoding API

          • 印刷する
          • PDF
          記事の要約

          VPC環境で利用できます。

          入力した座標を住所情報(法定洞、行政洞、地番住所、道路名住所など)に変換します。

          参考

          Reverse Geocoding APIは、EPSG(European Petroleum Survey Group)が指定した一部座標システムと韓国で主に使用する座標システムをサポートします。サポートする座標システムの詳細は、座標システムをご参照ください。

          リクエスト

          リクエスト形式を説明します。リクエスト形式は次の通りです。

          メソッドURI
          GET/gc

          リクエストヘッダ

          Maps APIで共通して使用されるヘッダの詳細は、Mapsの共通ヘッダをご参照ください。

          リクエストクエリパラメータ

          リクエストクエリパラメータの説明は次の通りです。

          フィールドタイプ必須の有無説明
          coordsStringRequired座標(X座標,Y座標)
          • <例> coords=128.12345,37.98776
          sourcecrsStringOptional入力座標系コード
          • EPSG:4326(デフォルト) | EPSG:3857 | NHN:2048
            • EPSG:4326: WGS84経緯度
            • EPSG:3857: Googleマップ
            • NHN:2048: UTM-K
          • サポートする座標系コードは座標システムを参照
          targetcrsStringOptional出力座標系コード
          • EPSG:4326(デフォルト) | EPSG:3857 | NHN:2048
            • EPSG:4326: WGS84経緯度
            • EPSG:3857: Googleマップ
            • NHN:2048: UTM-K
          • サポートする座標系コードは座標システムを参照
          ordersStringOptional変換タイプ
          • legalcode(デフォルト) | admcode(デフォルト) | addr | roadaddr
            • legalcode: 法定洞に変換
            • admcode: 行政洞に変換
            • addr: 地番住所に変換
            • roadaddr: 道路名住所に変換
          • 「,」で区切って複数のオプション値を入力でき、入力順に結果を表示
          • 海岸線付近や新規宅地など、詳細住所がない地域の座標変換の際はaddrまたはroadaddrでリクエストすると結果が返されないことがあるが、legalcodeまたはadmcodeでリクエストすると法定洞または行政洞単位の住所が確認できる
          • <例> orders=legalcode,addr
          outputStringOptionalレスポンス結果の形式タイプ
          • xml(デフォルト) | json
          callbackStringOptionalコールバック名
          • JSONP通信のためにコールバック処理時に利用
          • 入力した名前で JSONデータをラップして返す
          • outputがjsonの場合にのみ入力可能
          • <例> callback=abc

          座標システム

          座標システムの説明は次の通りです。

          名前コード区分GCS情報PCS情報
          GoogleマップEPSG:3857PCSWGS_1984WGS_19846378137 (Semi_Minor)298.2572236GreenwichDegreeM0000Meter1
          WGS 84経緯度EPSG:4326GCSWGS_1984WGS_19846378137298.2572236GreenwichDegree-------
          UTM-KNHN:2048PCSD_ITRF_2000GRS_19806378137298.2572221GreenwichDegreeTM127.5382,000,0001,000,000Meter0.9996

          リクエスト例

          リクエストのサンプルコードは次の通りです。

          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}'
          参考

          入力した座標に応じてさまざまなレスポンス結果が返される場合があります。次のリクエストのサンプルコードをご参照ください。

          • 一般の邑/面/洞
            • 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
          • 一般の里: 法定洞単位の邑/面下位の里単位の座標はadmcodeの結果でもcodeTypeがLと表示される
            • 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
          • 領域は異なるが、法定洞と同じ名前の行政洞が存在する場合
            • 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
          • 世宗市: 市/郡/区に関するデータが存在せず、領域は異なるが、下位のすべての行政洞の法定洞が同様に表示される
            • 世宗市オジン洞: 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
            • 世宗市鳥致院邑: 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
          • 海の上の座標: レスポンス結果は表示されない
            • 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

          レスポンス

          レスポンス形式を説明します。

          レスポンスボディ

          レスポンスボディの説明は次の通りです。

          フィールドタイプ必須の有無説明
          statusObject-レスポンスステータスに関する情報
          status.codeInteger-レスポンスステータスコード
          status.nameString-レスポンスステータスメッセージ
          status.messageString-レスポンスステータスに関する説明
          resultsArray-応答の結果

          results

          resultsの説明は次の通りです。

          フィールドタイプ必須の有無説明
          nameString-変換タイプ
          codeObject-コード情報
          code.idString-コード ID
          code.typeString-コードタイプ
          • L | A | S
            • L: 法定洞
            • A: 行政洞
            • S: 領域は異なるが、同じ名前の法定洞が存在する行政洞
          code.mappingIdString-法定/行政コードにマッピングされた NAVER洞コードの ID
          regionObject-住所情報
          region.areaNObject-行政区域情報
          • 変換された住所の最も大きな行政区域単位から順に表示
          region.areaN.nameString-行政区域単位名
          • region.area0.name: 国コードの最上位ドメインで、krと表示
          • region.area1.name: 行政安全部が公示した市/道名
          • region.area2.name: 行政安全部が公示した市/郡/区名
          • region.area3.name: 行政安全部が公示した邑/面/洞名
          • region.area4.name: 行政安全部が公示した里の名前
          region.areaN.coordsObject-行政区域の位置情報
          region.areaN.coords.centerObject-行政区域の中心座標
          region.areaN.coords.center.crsString-座標系コード
          region.areaN.coords.center.xFloat-X座標
          • land.coords.center.crsがEPSG:4326の場合、経度
          region.areaN.coords.center.yFloat-Y座標
          • land.coords.center.crsがEPSG:4326の場合、緯度
          landObject-詳細住所情報
          land.typeString-地籍のタイプ
          • nameがaddrの場合にのみ詳細値を表示
          • 1 | 2
            • 1: 一般の土地
            • 2: 山
          land.nameString-道路名
          • nameがroadaddrの場合にのみ詳細値を表示
          land.number1String-詳細番号
          • nameがaddrの場合、土地の本番号
          • nameがroadaddrの場合、詳細住所
          land.number2String-土地の副番号
          • nameがaddrの場合にのみ詳細値を表示
          land.coordsObject-詳細住所の位置情報
          land.coords.centerObject-詳細住所の中心座標
          land.coords.center.crsString-座標系コード
          land.coords.center.xFloat-X座標
          • land.coords.center.crsがEPSG:4326の場合、経度
          land.coords.center.yFloat-Y座標
          • land.coords.center.crsがEPSG:4326の場合、緯度
          land.additionNObject-追加情報
          • nameがroadaddrの場合にのみ詳細値を表示
          • land.addition0: 建物情報
          • land.addition1: 郵便番号情報
          • land.addition2: 道路コード情報
          land.additionN.typeString-追加情報のタイプ
          • land.addition0.type: building
          • land.addition1.type: zipcode
          • land.addition2.type: roadGroupCode
          land.additionN.valueString-追加情報の値
          • land.addition0.value: 建物名
          • land.addition1.value: 郵便番号
          • land.addition2.value: 道路コード(12桁)

          レスポンスステータスコード

          レスポンスステータスコードの説明は次の通りです。

          HTTPステータスコードコードメッセージ説明
          2000okリクエスト処理成功。レスポンス結果を返す
          2003no resultsリクエスト処理成功。レスポンス結果を返さない
          400100invalid requestリクエストパラメータエラー
          500900unknown error / io error定義されていないエラー
          参考

          Maps APIで共通して使用されるレスポンスステータスコードの詳細は、Mapsの共通レスポンスステータスコードをご参照ください。

          レスポンス例

          レスポンスのサンプルコードは次の通りです。

          {
    "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": "全羅南道",
                    "coords": {
                        "center": {
                            "crs": "EPSG:4326",
                            "x": 126.957167,
                            "y": 34.900727
                        }
                    },
                    "alias": "全南"
                },
                "area2": {
                    "name": "光陽市",
                    "coords": {
                        "center": {
                            "crs": "EPSG:4326",
                            "x": 127.695899,
                            "y": 34.940658
                        }
                    }
                },
                "area3": {
                    "name": "光陽邑",
                    "coords": {
                        "center": {
                            "crs": "EPSG:4326",
                            "x": 127.58105,
                            "y": 34.97341
                        }
                    }
                },
                "area4": {
                    "name": "邑內里",
                    "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": "全羅南道",
                    "coords": {
                        "center": {
                            "crs": "EPSG:4326",
                            "x": 126.957167,
                            "y": 34.900727
                        }
                    },
                    "alias": "全南"
                },
                "area2": {
                    "name": "光陽市",
                    "coords": {
                        "center": {
                            "crs": "EPSG:4326",
                            "x": 127.695899,
                            "y": 34.940658
                        }
                    }
                },
                "area3": {
                    "name": "光陽邑",
                    "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": "全羅南道",
                    "coords": {
                        "center": {
                            "crs": "EPSG:4326",
                            "x": 126.957167,
                            "y": 34.900727
                        }
                    },
                    "alias": "全南"
                },
                "area2": {
                    "name": "光陽市",
                    "coords": {
                        "center": {
                            "crs": "EPSG:4326",
                            "x": 127.695899,
                            "y": 34.940658
                        }
                    }
                },
                "area3": {
                    "name": "光陽邑",
                    "coords": {
                        "center": {
                            "crs": "EPSG:4326",
                            "x": 127.58105,
                            "y": 34.97341
                        }
                    }
                },
                "area4": {
                    "name": "邑內里",
                    "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": "全羅南道",
                    "coords": {
                        "center": {
                            "crs": "EPSG:4326",
                            "x": 126.957167,
                            "y": 34.900727
                        }
                    },
                    "alias": "全南"
                },
                "area2": {
                    "name": "光陽市",
                    "coords": {
                        "center": {
                            "crs": "EPSG:4326",
                            "x": 127.695899,
                            "y": 34.940658
                        }
                    }
                },
                "area3": {
                    "name": "光陽邑",
                    "coords": {
                        "center": {
                            "crs": "EPSG:4326",
                            "x": 127.58105,
                            "y": 34.97341
                        }
                    }
                },
                "area4": {
                    "name": "邑內里",
                    "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": "メイルシジャンギル",
                "coords": {
                    "center": {
                        "crs": "",
                        "x": 0.0,
                        "y": 0.0
                    }
                }
            }
        }
    ]
}
          この記事は役に立ちましたか?
          What's Next
          Change password!
          Changing your password will log you out immediately. Use the new password to log back in.
          Change profile
          Success!
          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.
          Logout