geoLocation

印刷する
共有
PDF

Article Summary

Share feedback

Thanks for sharing your feedback!

リクエスト

API URL

GET https://geolocation.apigw.ntruss.com/geolocation/v2/geoLocation

リクエストのヘッダー

ヘッダー名	説明
x-ncp-apigw-timestamp	1970年1月1日00:00:00協定世界時(UTC)からの経過時間をミリ秒(Millisecond)で表現し、API Gatewayサーバとの時間差が5分以上の場合は有効でないリクエストとみなす。 `x-ncp-apigw-timestamp:{Timestamp}`
x-ncp-iam-access-key	NAVERクラウドプラットフォームのポータルから発行したAccess Key IDの値 `x-ncp-iam-access-key:{Sub Account Access Key}`
x-ncp-apigw-signature-v2	Access Key IDの値とSecret Keyで暗号化した署名 `x-ncp-apigw-signature-v2:{API Gateway Signature}`

リクエストパラメータ

パラメータ名	必須	タイプ	制約事項	説明
ip	Y	String	IPv4アドレス - ウィキペディア	地域情報が知りたいユーザのIP
enc	N	String	utf8(デフォルト値)またはeuckr	レスポンス結果のエンコーディングタイプ
ext	N	String	tまたはf(デフォルト値)	追加情報の有無 t：あり f：なし
responseFormatType	N	String	xml(デフォルト値)またはjson	レスポンス結果のフォーマットタイプ

レスポンス

項目	タイプ	説明
requestId	String	APIリクエストのID
returnCode	String	正常Codeは0、その他はエラーコード
contry	String	国家コードとしてhttps://ja.wikipedia.org/wiki/ISO_3166 の他にEU(欧州)、AP(アジア、豪州)、A1(Anonymous Proxy)、A2(Satellite provider)、O1(Other Country)を含む
code	String	韓国の場合は行政自治部で定める行政区域のコードを表示する
r1	String	道、広域市、州
r2	String	市、郡、区
r3	String	洞、面、邑
lat	Number	緯度
long	Number	軽度
net	String	通信会社名

例示

レスポンス

国内、ext=f, xml

<getLocationResponse>
     <requestId>c4e52003-7879-4216-8eb5-66c93acfd0d2</requestId>
     <returnCode>0</returnCode>
     <geoLocation>
       <country>KR</country>
       <code>4113558000</code>
       <r1>경기도</r1>
       <r2>성남시 분당구</r2>
     </geoLocation>
</getLocationResponse>

国内、ext=f, json

{
	"returnCode": 0,
	"requestId": "c4e52003-7879-4216-8eb5-66c93acfd0d2",
	"geoLocation": {
		"country": "KR",
		"code": "4113558000",
		"r1": "경기도",
		"r2": "성남시 분당구"
	}
}

海外、ext=f, xml

<getLocationResponse>
     <requestId>c4e52003-7879-4216-8eb5-66c93acfd0d2</requestId>
     <returnCode>0</returnCode>
     <geoLocation>
       <country>US</country>
       <code/>
       <r1>California</r1>
       <r2>San Francisco</r2>
     </geoLocation>
</getLocationResponse>

海外、ext=f, json

{
	"returnCode": 0,
	"requestId": "c4e52003-7879-4216-8eb5-66c93acfd0d2",
	"geoLocation": {
		"country": "US",
		"code": "",
		"r1": "California",
		"r2": "San Francisco"
	}
}

国内、ext=t, xml

<getLocationResponse>
     <requestId>c4e52003-7879-4216-8eb5-66c93acfd0d2</requestId>
     <returnCode>0</returnCode>
     <geoLocation>
       <country>KR</country>
       <code>4113558000</code>
       <r1>경기도</r1>
       <r2>성남시 분당구</r2>
       <r3>서현1동</r3>
       <lat>37.3829030</lat>
       <long>127.126290</long>
       <net>Korea Net</net>
     </geoLocation>
</getLocationResponse>

国内、ext=t, json

{
	"returnCode": 0,
	"requestId": "c4e52003-7879-4216-8eb5-66c93acfd0d2",
	"geoLocation": {
		"country": "KR",
		"code": "4113558000",
		"r1": "경기도",
		"r2": "성남시 분당구",
        "r3": "서현1동",
        "lat": 37.3829030,
        "long": 127.126290,
        "net": "Korea Net"
	}
}

海外、ext=t, xml

<getLocationResponse>
     <requestId>c4e52003-7879-4216-8eb5-66c93acfd0d2</requestId>
     <returnCode>0</returnCode>
     <geoLocation>
       <country>US</country>
       <code/>
       <r1>California</r1>
       <r2>San Francisco</r2>
       <r3></r3>
       <lat>37.769700</lat>
       <long>-122.393300</long>
       <net>Fastly</net>
     </geoLocation>
</getLocationResponse>

海外、ext=t, json

{
	"returnCode": 0,
	"requestId": "c4e52003-7879-4216-8eb5-66c93acfd0d2",
	"geoLocation": {
		"country": "US",
		"code": "",
		"r1": "California",
		"r2": "San Francisco",
        "r3": "",
        "lat": 37.769700,
        "long": -122.393300,
        "net": "Fastly"
	}
}

エラーコード

エラーコード	レスポンスメッセージ	説明
131000	No Entry	地域情報が見つからない場合に発生します。他のIPを使って照会してください。
131001	Invalid IP	パブリックIPでない場合やIPアドレスのフォーマットが間違った場合に発生します。正常なIPアドレスのフォーマットはIPv4 - ウィキペディアをご参照ください。
131002	Internal Server Error	GeoLocationサーバのエラーにより発生します。一時的でない場合はお客様サポート > お問い合わせにお問い合わせください。
131003	Quota Limit Reached	設定したQuotaの上限までのAPIが使用されました。NAVERクラウドプラットフォームのコンソール> AI·NAVER API > GeoLocation > Quota SettingメニューからQuotaを変更することができます。
131004	Subscription Required	NAVERクラウドプラットフォームのコンソール > AI·NAVER API > GeoLocation > Subscriptionのメニューから利用申込をしてからご利用ください。

この他のコード値についてはNAVER Cloud Platform API >エラーの処理をご参照ください。

サンプル例題

Geolocation サンプル例題ダウンロード

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

What's Next

getQuota

リクエスト
レスポンス
例示
エラーコード
サンプル例題

タグ

GeoLocation