「どこどこJP」とは、WEBサイトへアクセスしているユーザーのIPアドレスをもとに、
エリア情報（国、都道府県、市区町村）や組織情報などを判定するAPIサービスです。
簡単なご利用登録をしていただくだけで、これらの情報を簡単に取得することができます。
是非、新しいサイトや既存コンテンツにお役立て下さい。
APIリファレンス
利用できるAPI
「どこどこJP」では、現在以下のAPIを公開しています。
指定のURLにアクセスすることで、JavaScriptやXML、JSONなどの形式で結果を出力する事ができます。
- JavaScript API
- JavaScriptの関数をブラウザに実行させることで判定結果を取得するAPIです。
- REST API
- XMLおよびJSON形式で判定結果を取得できるAPIです。
- リクエスト情報取得API
- どこどこJP側に処理をさせた結果を取得するためのAPIです。
- Demo
- 上述のAPI３種のダミーデータをご用意しております。ユーザー登録前の下調べや開発期間などにお役立て下さい。
利用可能データ
「どこどこJP」では、現在大きく分けて６種類のデータをご利用いただく事が出来ます。
利用可能データ参照ページの内訳は下記の通りです。
- 国データ
- ISO 3166-1に準拠した国コードのほか、英語表記、日本語表記の国名で値を返します。
- 都道府県データ
- 総務省設定の全国地方公共団体コードを基準にした都道府県コード（JIS X 0401）のほか、 英語表記、日本語表記の都道府県名で値を返します。
- 市区町村データ
- 総務省設定の全国地方公共団体コードを基準にした市区町村コード（JIS X 0402）のほか、 英語表記、日本語表記の市区町村名で値を返します。
- 地方判定データ
- デフォルトでは地方の値を返しませんが、拡張プラグインを用いる事で対応が可能です。
- 組織データ
- 日本標準産業分類に準拠した業種コード（大分類・中分類・小分類・細分類）のほか、
企業フラグ、本支店フラグ、自営業フラグ、上場区分フラグ、資本金コード、従業員数コード、売上高コードといった値を返します。 - 環境データ
- 主に回線種別（FTTH、ADSL、ISDN、ダイヤルアップ）の値を返します。
- CF値
- Confidence Factorの略で、データの「確かさ」を判断するための指標です。詳細はCF値の解釈についての項をご参照下さい。
拡張プラグインについて
どこどこJP(v3) 拡張プラグインを使用する事で下記の機能が追加されます。
- 都道府県付き都道府県名
- 通常はSample１のように都道府県区分無しで返りますが、Sample２のように都道府県区分が付きます。
Sample１：『取得中』
Sample２：『取得中』 - 地方分類
- デフォルトでは都道府県・市区町村しか返しませんが、簡単に地方区分を返す事が出来るようになります。
Sample：『取得中』 - 企業住所
- 企業からのアクセスに関して、簡単に市区町村以下の住所を返す事が出来るようになります。
Sample：『取得中』 - 拡張プラグインリファレンスページ
- 詳細につきましては、下記ページにてご確認下さい。
プラグイン自体の配布もリンク先ページとなっております。
CF値について（ Confidence Factor ）
データの「確かさ」を判断するための指標で、当社ネットワーク地理分析士（NGA）が調査したIPアドレスをスコア付けしたものです。
CFの範囲は0から100までの値をとり、値が大きいほどその情報が信頼できるものである事を示します。
CF値の解釈について
都道府県判定、市区町村判定において、CF値は以下のような意味を持ちます。
| 100～91 | Excellent（確かな判定が可能） | 調査レベル | 全てのネットワーク調査項目で判定＋目視による確認を実施。 |
|---|---|---|---|
| 利用用途の例 | 不正アクセス対策・ネットワークセキュリティ | ||
| 90～81 80～71 |
Good + Good（ほぼ正確な判定が可能） |
調査レベル | 多くのネットワーク調査項目で判定。 |
| 利用用途の例 | リスクベース認証 | ||
| 70～61 60～31 |
Good - Fair（おおむね判定可能） |
調査レベル | 複数のネットワーク調査項目で判定。 |
| 利用用途の例 | ログ解析・エリアターゲティング | ||
| 30～1 | Poor（不確定さを含んだ判定） | 調査レベル | 一部のネットワーク調査項目で判定。 |
| 利用用途の例 | コンテンツの地域別表示 | ||
| 0 | None（判定できない） | 調査レベル | 国内で使用されているIPアドレスではあるが判定できなかった。 |
| 利用用途の例 | 国内国外の判定 |
利用方法
ご利用を開始するためには、無料のアカウント登録を行った上でのAPIキー発行が必要となります。以下の手順で手続きを行って下さい。
APIキーは一意のドメインに対して有効です。
複数ドメインでご利用をお考えの場合は、それぞれのドメインごとにAPIキーを発行していただく必要がございます。
[アカウント登録]
- 無料のアカウント登録 にて「個人情報の取り扱い」について同意の上、お申込みください。
- ご本人様確認の為、入力いただいたメールアドレスに対して本登録依頼メールが送信されます。
メール本文中のURLにアクセスし、登録を完了して下さい。 - 登録完了することで、管理画面のログインが可能となります。
[APIキー発行]
- アカウント登録後に管理画面にログインしてください。
- 画面左側のメニューの「申込み」より、「利用規約」の同意の上、APIキーの発行を申請します。
- 登録完了画面でAPIキーが発行され、どこどこJPが利用可能になります。
APIキー発行後は、APIキー管理画面にて、利用状況の確認ができます。
利用料金
本サービスは、非商用の個人様のみ無料とさせていただきます。
法人または、商用利用の方は料金表をご確認ください。
※有料利用の場合、申込み日～月末までの期間が無料の試用期間となります。
開発期間が複数月におよぶ場合等につきましては、DEMOのダミーデータをご活用頂けますと幸いです。
