ジオターゲティング：API仕様説明書

ジオターゲティングによる地域判定は、弊社が管理するサーバより提供されるAPIによって提供されます。
下記リクエストにより地域コード判定結果をリターンします。

※ご利用には、アカウントIDとパスワードが必要です。

はじめに

ジオターゲティングの商用利用での導入ご検討の方、若しくは非商用サイト等でのご利用を希望の方に対し、無償で利用できるテストアカウントを用意しております。
1日当り500リクエストを上限として、下記に記述する試験環境にてジオターゲティングAPIをお試し頂けます。

API(試験環境)を呼び出すURL

下記URLでリクエストします。

地域コードををリクエストする場合

http://www1.geotg.jp/sample.geo?ip=[IPアドレス]&id=[アカウントID]&pw=[アカウントパスワード]&format=[フォーマット]

地域コード+ドメインをリクエストする場合

http://www1.geotg.jp/sample2.geo?ip=[IPアドレス]&id=[アカウントID]&pw=[アカウントパスワード]&format=[フォーマット]

試験環境ではアカウントID:sample　アカウントパスワード:testを使用

※1日500リクエストまで無料で試用ができます。

API(本番環境)を呼び出すURL

下記URLでリクエストします。

地域コードを返す場合

http://geotg.jp/geo.geo?ip=[IPアドレス]&id=[アカウントID]&pw=[アカウントパスワード]&format=[フォーマット]

地域コード+ドメインを返す場合

http://geotg.jp/geo2.geo?ip=[IPアドレス]&id=[アカウントID]&pw=[アカウントパスワード]&format=[フォーマット]

パラメータの説明

各パラメータは以下のようになっています。

レスポンスの説明

APIのレスポンス（戻り値）はJSON形式です。

{
    "region":"0",
    "domain":"-"
}

<?xml version="1.0" encoding="UTF-8"?>
<results xmlns="http://geotg.jp/">
<region>0</region>
<domain>-</domain>
</results>

エラーの説明

エラー（リクエスト失敗）が発生したときのAPIのレスポンスは以下のようになります。

{
    "error":"authentication failure"
}

<?xml version="1.0" encoding="UTF-8"?>
<results xmlns="http://geotg.jp/">
  <error>
    <message>authentication failure</message>
  </error>
</results>

エラーメッセージ一覧

エラーメッセージとその意味は以下のようになります。

地域コード一覧

地域コードと都道府県名の対応は以下のようになります。