gc
    • PDF

    gc

    • PDF

    Article Summary

    概要

    Naver地図は座標を住所に変換(coordsToAddr)するReverse geocodingサービスを提供します。Reverse geocoding APIを利用して特定の座標に該当する韓国国内の法政洞/行政洞/地番住所/道路名住所情報を取得できます。

    Reverse geocodingサービスはEPSG(European Petroleum Survey Group)で指定した一部座標体系と韓国国内で主に使う座標体系をサポートします。

    リクエスト

    curl "https://naveropenapi.apigw.ntruss.com/map-reversegeocode/v2/gc?coords={入力_座標}&sourcecrs={座標系}&orders={変換_作業_名称}&output={出力_形式}" \
    	-H "X-NCP-APIGW-API-KEY-ID: {アプリケーションを登録する時に発行されたclient id値}" \
    	-H "X-NCP-APIGW-API-KEY: {アプリケーションを登録する時に発行されたclient secret値}" -v
    

    リクエストパラメータ

    • sourcecrs、targetcrs、orders、outputパラメータの場合、該当パラメータが入力されないとdefault値(基本値)で呼び出されます。各パラメータ別のdefault値は以下の説明をご参考ください。
    • default値でない値が必要な場合は該当パラメータを明示的に呼び出すことも可能です。
    • ordersパラメータを呼び出さない場合 : 法政、行政結果リターン
    • 詳細住所が必要な場合 : orders=legalcode,admcode,addr,roadaddrで呼び出す。
    • (詳細住所の呼び出しにordersパラメータ値としてlegalcodeやadmcodeを追加して呼び出す理由 : 海岸線付近、新規住宅地などの詳細住所がない地域の場合、APIの結果として'結果なし'ではなく、法政または行政洞単位の結果を取得可能)
    パラメータデータタイプ必須説明
    requeststringNリクエストサービス名
    Reverse geocodingではcoordsToaddrを使います。
    default値(基本値)はcoordToaddrです。
    例) request=coordsToaddr
    coordsstringY入力座標
    例) coords=128.12345,37.98776
    sourcecrsstringN入力座標系コード
    default値(基本値)は経緯度座標系(epsg:4326)です。
    サポートされる座標系コードは座標体系をご参考ください。
    例) sourcecrs=epsg:4326 (経緯度座標系)
    sourcecrs=nhn:2048 (utm-k座標系)
    sourcecrs=nhn:128 (katech座標系)
    sourcecrs=epsg:3857 (google座標系)
    targetcrsstringN出力座標系コード
    default値(基本値)は経緯度座標系(epsg:4326)です。
    サポートされる座標系コードは座標体系をご参考ください。
    例) targetcrs=epsg:4326 (経緯度座標系)
    targetcrs=nhn:2048 (utm-k座標系)
    targetcrs=nhn:128 (katech座標系)
    targetcrs=epsg:3857 (google座標系)
    ordersstringN変換作業名称
    default値(基本値)はlegalcode,admcodeです。
    使用可能な値は以下の通りです。
    - legalcode: 座標 to 法政洞
    - admcode: 座標 to 行政洞
    - addr: 座標 to 地番住所
    - roadaddr: 座標 to 道路名住所(新しい住所)
    多くの値を入力できますし、ordersリクエスト順で結果が表示されます。
    例) orders=legalcode
    orders=addr,admcode
    orders=addr,admcode,roadaddr
    orders=legalcode,addr,admcode,roadaddr
    outputstringN出力形式
    使用可能な値はjson, xmlです。
    default値(基本値)はxmlです。
    例) output=json
    output=xml
    callbackstringNjsonp通信のためにcallback処理が必要な場合に渡すcallback名
    output=jsonの場合のみ該当する
    callbackで指定した名称で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
    KATECH(TM128)NHN:128マッシュアップマップ、百科事典、ウェブ OpenAPIPCSD_Korean_Datum_1985Bessel 18416377397.155299.1528128GreenwichDegreeTM12838600,000400,000Meter0.9999타원체 変換계수 10개 : TRANSFORM"BADEKAS","-145.907,505.034,685.756,-1.162,2.347,1.592,6.342,-3159521.31,4068151.32,3748113.85"

    リクエストヘッダ

    ヘッダ名説明
    X-NCP-APIGW-API-KEY-IDアプリケーションを登録する時に発行されたClient ID
    X-NCP-APIGW-API-KEY-ID:{Client ID}
    X-NCP-APIGW-API-KEYアプリケーションを登録する時に発行されたClient Secret
    X-NCP-APIGW-API-KEY:{Client Secret}

    リクエストボディ

    • 該当APIはリクエストボディが必要ありません。

    レスポンス

    レスポンスボディ

    属性データタイプ説明
    namestring変換作業名称
    codenumberコード情報
    code.idstringコード値
    code.typestringコードタイプ
    例) L: 法政洞, A: 行政洞, S: 同一法政洞名が存在する行政洞
    code.mappingIdstringidと関連されたマッピングコード
    例) 法政コードにマッピングされたNaver洞コードまたは行政コードにマッピングされたNaver洞コード
    region地域名称情報
    region.area0
    region.area0.namestring国家コードの最上位ドメインの2桁
    詳しい内容については Country code top-level domainをご参考ください。
    region.area0.coords.center行政区域の中心座標
    region.area0.coords.center.crsstring座標系コード
    サポートされる座標系コードは座標体系をご参考ください。
    region.area0.coords.center.xfloatx軸座標
    例) 経緯度(epsg:4326)である場合は経度(longitude)
    region.area0.coords.center.yfloaty軸座標
    例) 経緯度(epsg:4326)である場合は緯度(latitude)
    region.area1
    region.area1.namestring行政区域単位名称1
    例) 大韓民国の場合、行政安全部から公示された市/道の名称
    region.area1.coords行政区域と関連された座標
    region.area1.coords.center行政区域の中心座標
    region.area1.coords.center.crsstring座標系コード
    サポートされる座標系コードは座標体系をご参考ください。
    region.area1.coords.center.xfloatx軸座標
    例) 経緯度(epsg:4326)である場合は経度(longitude)
    region.area1.coords.center.yfloaty軸座標
    例) 経緯度(epsg:4326)である場合は緯度(latitude)
    region.area2
    region.area2.namestring行政区域単位名称2
    例) 大韓民国の場合、行政安全部から公示された市/郡/区の名称
    region.area2.coords行政区域と関連された座標
    region.area2.coords.center行政区域の中心座標
    region.area2.coords.center.crsstring座標系コード
    サポートされる座標系コードは座標体系をご参考ください。
    region.area2.coords.center.xfloatx軸座標
    例) 経緯度(epsg:4326)である場合は経度(longitude)
    region.area2.coords.center.yfloaty軸座標
    例) 経緯度(epsg:4326)である場合は緯度(latitude)
    region.area3
    region.area3.namestring行政区域単位名称3
    例) 大韓民国の場合、行政安全部から公示された邑/面/洞の名称
    region.area3.coords行政区域と関連された座標
    region.area3.coords.center行政区域の中心座標
    region.area3.coords.center.crsstring座標系コード
    サポートされる座標系コードは座標体系をご参考ください。
    region.area3.coords.center.xfloatx軸座標
    例) 経緯度(epsg:4326)である場合は経度(longitude)
    region.area3.coords.center.yfloaty軸座標
    例) 経緯度(epsg:4326)である場合は緯度(latitude)
    region.area4
    region.area4.namestring行政区域単位名称4
    例) 大韓民国の場合、行政安全部から公示された里の名称)
    region.area4.coords行政区域と関連された座標
    region.area4.coords.center行政区域の中心座標
    region.area4.coords.center.crsstring座標系コード
    サポートされる座標系コードは座標体系をご参考ください。
    region.area4.coords.center.xfloatx軸座標
    例) 経緯度(epsg:4326)である場合は経度(longitude)
    region.area4.coords.center.yfloaty軸座標
    例) 経緯度(epsg:4326)である場合は緯度(latitude)
    land詳細住所情報
    land.typestring地番住所の場合、地籍タイプ
    例) 大韓民国の地番住所である場合 1: 一般土地、 2: 山  
    道路名住所の場合、reserved
    land.namestring詳細名称
    例) 大韓民国の地番住所である場合、reserved
    大韓民国の道路名住所である場合、道路名
    land.number1string詳細番号1
    例) 大韓民国の地番住所である場合、土地本番号
    大韓民国の道路名住所である場合、詳細住所
    land.number2string詳細番号2
    例) 大韓民国の地番住所である場合、土地副番号
    大韓民国の道路名住所である場合、reserved
    land.coords地籍広域に関係された座標 (reserved)
    addition0追加情報
    地番住所である場合、reserved
    道路名住所である場合、建物情報
    addition0.typestring道路名住所であり、建物情報がある場合、'building'
    addition0.valuestring道路名住所であり、建物情報がある場合、建物名
    addition1追加情報
    地番住所である場合、reserved
    道路名住所である場合、郵便番号
    addition1.typestring道路名住所であり、郵便番号情報がある場合、'zipcode'
    addition1.valuestring道路名住所であり、郵便番号情報がある場合、郵便番号
    addition2追加情報
    地番住所である場合、reserved
    道路名住所である場合、道路コード
    addition2.typestring道路名住所である場合、'roadGroupCode'
    addition2.valuestring道路名住所である場合、道路コード(12桁road group code)
    addutuib3~4reserved
    参考

    変換対象座標によって多様なレスポンス結果が返却されます。以下の各ケースをご参考ください。

    • 一般邑面洞

      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の結果にもcode typeは'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

    • 世宗市座標: 市郡区area2データがないし、世宗市下位のすべての行政洞の法政洞が同じです。(領域は異なる。)

      • ドダム洞(法政洞、行政洞が同一名称):
        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=xml

      • ジョチウォン邑(法政):
        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

    例示

    リクエスト例示

    curl "https://naveropenapi.apigw.ntruss.com/map-reversegeocode/v2/gc?request=coordsToaddr&coords=129.1133567,35.2982640&sourcecrs=epsg:4326&output=json&orders=legalcode,admcode" \
    	-H "X-NCP-APIGW-API-KEY-ID: {アプリケーションを登録する時に発行されたclient id値}" \
    	-H "X-NCP-APIGW-API-KEY: {アプリケーションを登録する時に発行されたclient secret値}" -v
    
    • 座標を法政コードに変換リクエスト
      https://naveropenapi.apigw.ntruss.com/map-reversegeocode/v2/gc?request=coordsToaddr&coords=129.1133567,35.2982640&sourcecrs=epsg:4326&output=json&orders=legalcode

    • 座標を地番住所、行政コードに変換リクエスト
      https://naveropenapi.apigw.ntruss.com/map-reversegeocode/v2/gc?request=coordsToaddr&coords=129.1133567,35.2982640&sourcecrs=epsg:4326&output=json&orders=addr,admcode

    • 座標を地番住所、行政コード、道路名住所に変換リクエスト
      https://naveropenapi.apigw.ntruss.com/map-reversegeocode/v2/gc?request=coordsToaddr&coords=129.1133567,35.2982640&sourcecrs=epsg:4326&output=json&orders=addr,admcode,roadaddr

    レスポンス例示

    {
        "status":{
                "code":0,
                "name":"ok",
                "message":"done"
            },
        "results":[
            {
                "name":"legalcode",
                "code":{
                    "id":"2641010100",
                    "type":"L",
                    "mappingId":"08410101"
                },
                "region":{
                    "area0":{
                        "name":"kr",
                        "coords":{
                            "center":{
                                "crs":"",
                                "x":0.0,
                                "y":0.0
                            }
                        }
                    },
                    "area1":{
                        "name":"釜山広域市",
                        "coords":{
                            "center":{
                                "crs":"EPSG:4326",
                                "x":129.0750222,
                                "y":35.1798159
                            }
                        }
                    },
                    "area2":{
                        "name":"クンジョン区",
                        "coords":{
                            "center":{
                                "crs":"EPSG:4326",
                                "x":129.0921,
                                "y":35.243068
                            }
                        }
                    },
                    "area3":{
                        "name":"ドゥグ洞",
                        "coords":{
                            "center":{
                                "crs":"EPSG:4326",
                                "x":129.1133567,
                                "y":35.2982641
                            }
                        }
                    },
                    "area4":{
                        "name":"",
                        "coords":{
                            "center":{
                                "crs":"",
                                "x":0.0,
                                "y":0.0
                            }
                        }
                    }
                }
            }
        ]
    }
    

    エラーコード

    リクエスト結果が正常である場合はHTTPステータスコード200を返却するし、詳細コードは以下のようです。

    codename説明
    0ok正常的な機能実行及び返却された結果がある場合
    3no results正常的な機能実行及び返却された結果がない場合

    リクエスト結果が正常でない場合は次のように返却されます。

    HttpStatusCodeErrorCodeErrorMessageDescription
    400100invalid requestリクエストパラメータが間違った場合
    500900unknown error / io error定義されてないエラー

    この記事は役に立ちましたか?

    What's Next
    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.