特徴
サイトにアクセスしてきたユーザーの位置情報(緯度経度)を取得し、その情報に紐づく地域・組織情報、アクセス時のIPアドレスから取得した接続環境情報を返却するAPIです。
緯度経度と組織情報の紐づけは2021年8月に開発した「Organization IP Location Matching」の一部機能をリアルタイムで行うように調整し、実現しております。
本機能を導入することにより、モバイルや一部の固定回線など判定が難しかったIPアドレスからのアクセスにも、より精度の高い地域情報、組織情報をご提供することが可能となりました。
緯度経度から特定した情報も従来のどこどこJPと同じフォーマットで返却しておりますので、これまでと同様の方法で、各種ツールと連携することができます。
判定例)
以下は静岡県にある端末からモバイル回線を使用した時に地域判定の違いについてです。
モバイル回線は複数県まとめて一つのゲートウェイサーバーを通過するため、IP検索では一番人口が集中する「東京都」の情報を付与しておりました。
しかし、緯度経度検索を使用することで、端末の緯度経度から地域を特定することができ、「静岡県」の情報を付与することが可能です。
利用上の注意
本機能は、ウェブの標準化団体であるW3Cが仕様策定を進める規格で、JavaScriptを利用して位置情報を取得する「Geolocation API」を使って緯度経度を取得しております。
上記APIはHTTPSサイトのみしか対応していないため、本機能もHTTPSサイトのみでご利用いただけます。
HTTPサイトでご利用いただいた場合、緯度経度が取得できないため、すべてIPアドレスから判明した地域・組織情報となります。
またプライバシー保護の観点から、ユーザーが緯度経度を送信するかどうかを判断できるよう、緯度経度の送信していいか確認をするポップアップが表示されるようになります。
ユーザーが緯度経度の送信をブロックした場合は、IPアドレスからの判定結果を返却いたします。
緯度経度から市区町村の特定につきましては、指定された緯度経度を第三次地域メッシュコードに変換し、総務省統計局が公開する「市区町村別メッシュ・コード一覧」と突き合わせて、市区町村を特定しています。
※地域メッシュとは
緯度・経度に基づいて地域を同じ大きさの網の目(メッシュ)に分けたもの。
識別するために各メッシュに割り当てたこーどをメッシュコードと呼ぶ。
一部のメッシュコードには、複数の市区町村が紐づく場合がございます。
その場合はその中で一番数字が小さい市区町村の情報を返却するようにしておりますので、一部の緯度経度では近隣の市区町村判定となる場合がございます。
対象範囲は日本の緯度経度のみとなります。
海外など、弊社が保持する緯度経度情報に該当しない緯度経度を指定され場合は、IPアドレスに紐づく地域・組織情報を返却いたします。
判定理由の見分け方
どこどこJPが返却した地域・組織情報が、緯度経度から判定した値か、IPアドレスから判定した値かの判断をした場合は、PrefCFをご活用ください。
緯度経度から判定した場合はPrefCFが99、IPアドレスから判定した場合はPrefCFは99より小さい値が入るように設定しております。
発行されるタグ
<script type="text/javascript">
var docodoco_key = {APIキー};
</script>
<script type="text/javascript" src="//api.docodoco.jp/search_latlon.js" charset="utf-8"></script>
<script>
function callback_docodoco(SURFPOINT_latlon){
//どこどこJPの取得結果を活用する部分は以下に記載してください
};
</script>
利用方法
どこどこJPご登録後、サイトにタグを埋め込むだけで、利用可能です。
サイト上のグローバル変数を通して属性値の取得を行います。 下記表は取得方法と取得できる値の一覧です。値は、現在アクセスされている環境の情報を表示しています。
赤文字は、緯度経度検索のみで使用される関数となります。
国
関数名 | 関数名 | 値サンプル | 取得先情報 | |
緯度経度送信OK | 緯度経度送信NG | |||
SURFPOINT_latlon.getContinentCode() | コード取得(大陸) | 取得中... | 緯度経度に紐づく情報 | IPアドレスに紐づく情報 |
SURFPOINT_latlon.getCountryCode() | コード取得(国) | 取得中... | 緯度経度に紐づく情報 | IPアドレスに紐づく情報 |
SURFPOINT_latlon.getCountryAName() | 英語表記取得 | 取得中... | 国コードに紐づく表記 | 国コードに紐づく表記 |
SURFPOINT_latlon.getCountryJName() | 日本語表記取得 | 取得中... | 国コードに紐づく表記 | 国コードに紐づく表記 |
都道府県
関数名 | 関数名 | 値サンプル | 取得先情報 | |
緯度経度送信OK | 緯度経度送信NG | |||
SURFPOINT_latlon.getRegionCode() | コード取得(地方) | 取得中... | 緯度経度に紐づく情報 | IPアドレスに紐づく情報 |
SURFPOINT_latlon.getPrefCode() | コード取得(都道府県) | 取得中... | 緯度経度に紐づく情報 | IPアドレスに紐づく情報 |
SURFPOINT_latlon.getPrefAName() | ローマ字表記取得 | 取得中... | 都道府県コードに紐づく表記 | 都道府県コードに紐づく表記 |
SURFPOINT_latlon.getPrefJName() | 日本語表記取得 | 取得中... | 都道府県コードに紐づく表記 | 都道府県コードに紐づく表記 |
SURFPOINT_latlon.getPrefLatitude() | 緯度取得 | 取得中... | Geolocation APIで取得した緯度 | 都道府県コードに紐づく情報 |
SURFPOINT_latlon.getPrefLongitude() | 経度取得 | 取得中... | Geolocation APIで取得した経度 | 都道府県コードに紐づく情報 |
市区町村
関数名 | 関数名 | 値サンプル | 取得先情報 | |
緯度経度送信OK | 緯度経度送信NG | |||
SURFPOINT_latlon.getCityCode() | コード取得(市区町村) | 取得中 | 緯度経度に紐づく情報 | IPアドレスに紐づく情報 |
SURFPOINT_latlon.getCityAName() | ローマ字表記取得 | 取得中... | 市区町村コードに紐づく表記 | 市区町村コードに紐づく表記 |
SURFPOINT_latlon.getCityJName() | 日本語表記取得 | 取得中... | 市区町村コードに紐づく表記 | 市区町村コードに紐づく表記 |
SURFPOINT_latlon.getCityLatitude() | 緯度取得 | 取得中... | Geolocation APIで取得した緯度 | 市区町村コードに紐づく情報 |
SURFPOINT_latlon.getCityLongitude() | 経度取得 | 取得中... | Geolocation APIで取得した経度 | 市区町村コードに紐づく情報 |
組織
関数名 | 関数名 | 値サンプル | 取得先情報 | |
緯度経度送信OK | 緯度経度送信NG | |||
SURFPOINT_latlon.getBCFlag() | 企業フラグ取得 | 取得中... | 該当組織コードに紐づく情報 | 該当組織コードに紐づく情報 |
SURFPOINT_latlon.getOrgCode() | コード取得(企業) | 取得中... | 緯度経度に紐づく情報 | IPアドレスに紐づく情報 |
SURFPOINT_latlon.getOrgOfficeCode() | 本支店フラグ取得 | 取得中... | 該当組織コードに紐づく情報 | 該当組織コードに紐づく情報 |
SURFPOINT_latlon.getOrgIndependentCode() | 自営業フラグ取得 | 取得中... | 該当組織コードに紐づく情報 | 該当組織コードに紐づく情報 |
SURFPOINT_latlon.getOrgName() | 企業名取得 | 取得中... | 該当組織コードに紐づく情報 | 該当組織コードに紐づく情報 |
SURFPOINT_latlon.getOrgPrefCode() | コード取得(都道府県) | 取得中... | 該当組織コードに紐づく情報 | 該当組織コードに紐づく情報 |
SURFPOINT_latlon.getOrgCityCode() | コード取得(市区町村) | 取得中... | 該当組織コードに紐づく情報 | 該当組織コードに紐づく情報 |
SURFPOINT_latlon.getOrgLatitude() | 緯度取得 | 取得中... | 該当組織コードに紐づく情報 | 該当組織コードに紐づく情報 |
SURFPOINT_latlon.getOrgLongitude() | 経度取得 | 取得中... | 該当組織コードに紐づく情報 | 該当組織コードに紐づく情報 |
SURFPOINT_latlon.getOrgZipCode() | 郵便番号取得 | 取得中... | 該当組織コードに紐づく情報 | 該当組織コードに紐づく情報 |
SURFPOINT_latlon.getOrgAddress() | 住所取得 | 取得中... | 該当組織コードに紐づく情報 | 該当組織コードに紐づく情報 |
SURFPOINT_latlon.getOrgTel() | 電話番号取得 | 取得中... | 該当組織コードに紐づく情報 | 該当組織コードに紐づく情報 |
SURFPOINT_latlon.getOrgFax() | FAX番号取得 | 取得中... | 該当組織コードに紐づく情報 | 該当組織コードに紐づく情報 |
SURFPOINT_latlon.getOrgIpoType() | 上場区分フラグ取得 | 取得中... | 該当組織コードに紐づく情報 | 該当組織コードに紐づく情報 |
SURFPOINT_latlom.getStockTickerNumber() | 証券コード取得 | 取得中... | 該当組織コードに紐づく情報 | 該当組織コードに紐づく情報 |
SURFPOINT_latlon.getOrgDate() | 設立年月日取得 | 取得中... | 該当組織コードに紐づく情報 | 該当組織コードに紐づく情報 |
SURFPOINT_latlon.getOrgCapitalCode() | 資本金コード取得 | 取得中... | 該当組織コードに紐づく情報 | 該当組織コードに紐づく情報 |
SURFPOINT_latlon.getOrgEmployeesCode() | 従業員数コード取得 | 取得中... | 該当組織コードに紐づく情報 | 該当組織コードに紐づく情報 |
SURFPOINT_latlon.getOrgGrossCode() | 売上高コード取得 | 取得中... | 該当組織コードに紐づく情報 | 該当組織コードに紐づく情報 |
SURFPOINT_latlon.getOrgPresident() | 代表者名取得 | 取得中... | 該当組織コードに紐づく情報 | 該当組織コードに紐づく情報 |
SURFPOINT_latlon.getOrgIndustrialCategoryL() | 業種大分類取得 | 取得中... | 該当組織コードに紐づく情報 | 該当組織コードに紐づく情報 |
SURFPOINT_latlon.getOrgIndustrialCategoryM() | 業種中分類取得 | 取得中... | 該当組織コードに紐づく情報 | 該当組織コードに紐づく情報 |
SURFPOINT_latlon.getOrgIndustrialCategoryS() | 業種小分類取得 | 取得中... | 該当組織コードに紐づく情報 | 該当組織コードに紐づく情報 |
SURFPOINT_latlon.getOrgIndustrialCategoryT() | 業種細分類取得 | 取得中... | 該当組織コードに紐づく情報 | 該当組織コードに紐づく情報 |
SURFPOINT_latlon.getOrgUrl() | WEBサイトアドレス取得 | 取得中... | 該当組織コードに紐づく情報 | 該当組織コードに紐づく情報 |
SURFPOINT_latlon.getOrgDomainName() | ドメイン名取得(組織データに基づく) | 取得中... | 該当組織コードに紐づく情報 | 該当組織コードに紐づく情報 |
SURFPOINT_latlon.getOrgDomainType() | ドメインタイプ取得(組織データに基づく) | 取得中... | 該当組織コードに紐づく情報 | 該当組織コードに紐づく情報 |
SURFPOINT_latlon.getOrgEnglishName() | 組織 社名・屋号英語表記 | 取得中... | 該当組織コードに紐づく情報 | 該当組織コードに紐づく情報 |
SURFPOINT.getOrgEnglishAddress() | 組織 住所英語表記 | 取得中... | 該当組織コードに紐づく情報 | 該当組織コードに紐づく情報 |
環境
関数名 | 関数名 | 値サンプル | 取得先情報 | |
緯度経度送信OK | 緯度経度送信NG | |||
SURFPOINT_latlon.getIP() | IPアドレス取得 | 取得中... | リクエストIPアドレス | リクエストIPアドレス |
SURFPOINT_latlon.getLatitude() | 緯度取得 | 取得中... | Geolocation APIで取得した緯度 | 該当項目なし |
SURFPOINT_latlon.getLongitude() | 経度取得 | 取得中... | Geolocation APIで取得した緯度 | 該当項目なし |
SURFPOINT_latlon.getLineCode() | 回線コード取得 | 取得中... | IPアドレスに紐づく情報 | IPアドレスに紐づく情報 |
SURFPOINT_latlon.getLineJName() | 回線日本語表記取得 | 取得中... | 回線コードに紐づく表記 | 回線コードに紐づく表記 |
SURFPOINT_latlon.getTimeZone() | タイムゾーン | 取得中... | 緯度経度に紐づく情報 | IPアドレスに紐づく情報 |
SURFPOINT_latlon.getTelCode() | 市外局番取得 | 取得中... | IPアドレスに紐づく情報 | IPアドレスに紐づく情報 |
SURFPOINT_latlon.getDomainName() | ドメイン名取得(IPに基づく) | 取得中... | IPアドレスに紐づく情報 | IPアドレスに紐づく情報 |
SURFPOINT_latlon.getDomainType() | ドメインタイプ取得(IPに基づく) | 取得中... | IPアドレスに紐づく情報 | IPアドレスに紐づく情報 |
SURFPOINT_latlon.getProxyFlag() | プロキシ判定取得 | 取得中... | IPアドレスに紐づく情報 | IPアドレスに紐づく情報 |
SURFPOINT_latlon.getEncryptedIP() | IPアドレスを暗号化した文字列 | 取得中... | IPアドレスに紐づく情報 | IPアドレスに紐づく情報 |
判定値(CF値)
関数名 | 関数名 | 値サンプル | 取得先情報 | |
緯度経度送信OK | 緯度経度送信NG | |||
SURFPOINT_latlon.getPrefCF() | 都道府県CF値取得 | 取得中... | 緯度経度に紐づく情報(99) | IPアドレスに紐づく情報(0~98のいずれか) |
SURFPOINT_latlon.getCityCF() | 市区町村CF値取得 | 取得中... | 緯度経度に紐づく情報(99) | IPアドレスに紐づく情報(0~98のいずれか) |
SURFPOINT_latlon.getLineCF() | 回線CF値取得 | 取得中... | IPアドレスに紐づく情報(0~99のいずれか) | IPアドレスに紐づく情報(0~99のいずれか) |