Download the PHP package demouth/dmgeocoder without Composer
On this page you can find all versions of the php package demouth/dmgeocoder. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download demouth/dmgeocoder
More information about demouth/dmgeocoder
Files in demouth/dmgeocoder
Package dmgeocoder
Short Description Geocoding library.
License MIT
Homepage https://github.com/demouth/DmGeocoder
Informations about the package dmgeocoder
DmGeocorder
PHP製の日本国内用ジオコーディングライブラリです。
住所から緯度経度を調べたり(ジオコーディング)、緯度経度から住所を調べたりすること(逆ジオコーディング)が可能です。
特徴
- 一般的にプログラムからジオコーディングをする時、Google Geocording APIのようなジオコーディングAPIを利用しますが、当ライブラリは地理情報をライブラリ内に持ちジオコーディングAPIを利用しません。これによりジオコーディングAPIを利用した実装とは違い、回数制限など気にせず利用することが可能です。これがこのライブラリ最大の特徴です。
- 当ライブラリのソースをサーバーに配置するだけで利用可能です(ジオコーディングAPIやDBを使っていない為特にライブラリを利用するための準備、サーバー設定は不要)。
- 丁番号程度の多少の表記の揺らぎについては対応しています(詳しくは使い方を参照)。
- 日本国内のみに対応していて、国外のジオコーディングは出来ません。
- 緯度経度は世界測地系です。
- 精度は大字・町丁目レベルで、街区情報は持ちません。
- 位置情報は平成24年度版のデータを利用しています。翌年版のデータが公開されたらcsvディレクトリに配置されているcsvファイルを差し替えれば利用可能です。
- PHP5.0以上で利用可能で、PHP5.3以下でも使えるようにnamespaceは使用していません。
使い方
使い方1 住所名から緯度経度を取得する
住所文字列をDm_Geocoder::geocode()の第一引数に渡すと、引数を元に住所検索を行い、詳細な住所情報を返します。
この住所情報には緯度経度情報を含みます。
可能性の高い位置情報が複数存在した場合は、それらの住所をすべて返します。
検索結果が複数件存在した場合、より可能性の高い住所を複数返します。
住所の表記ゆらぎをある程度サポートしていますので、下記例のような検索が可能です。
ただし下記の例に出てこないような検索、例えば「新宿区」を「しんじゅくく」といったものには対応していません。
使い方2 緯度経度から該当する住所を検索する
Dm_Geocoder::reverseGeocode(緯度,軽度)と渡すと、その緯度経度から近い順に住所情報を複数返します。
第三引数に検索結果の返却数を指定できます
include/reqiure方法
下記のいずれかの方法でライブラリを読み込んでください。
読み込みができていればクラスを使える状態になっています。
composerを利用する場合
下記のcomposer.jsonを書いてinstallしてください。
手動でファイルをrequireする場合
ソースをダウンロードして、下記のようにsrcディレクトリ以下のソースを読み込んでください。
注意点
- UTF-8以外はサポートしません。mb_internal_encoding('UTF-8');にした状態で、検索文字列にはUTF-8の文字列を渡してください。検索結果もUTF-8で返します。