クイックスタート

GeoNLP の全ての解析機能は、コードを書かなくてもコマンドラインプログラムから利用できます。

このページはバージョン 1.2.0 のレスポンスを利用しています。 1.1.0 より古いバージョンの情報は クイックスタート(バージョン1.1.0まで) を参照してください。

テキストに含まれる地名語を抽出する

parse メソッドを呼び出すリクエストを作成し、 geonlp_api コマンドで処理します。 リクエストおよびレスポンスの詳細については parse の説明を参照してください。

$ echo '{"method":"geonlp.parse","params":["沖縄県の南海上で台風が発生しました"], "id":1}' | geonlp_api
{"error":null,"id":1,"result":{"features":[{"geometry":{"coordinates":[127.679630,26.213300],"type":"Point"},"properties":{"address":"那覇市泉崎1-2-2","address_level":"1","body":"沖縄","body_kana":"オキナワ","code":{"jisx0401":"47","lasdec":"470007"},"dictionary_id":28,"entry_id":"47","fullname":"沖縄県","geonlp_id":"GzfYzt","kana":"オキナワケン","latitude":"26.2133","longitude":"127.67963","name":"沖縄県","ne_class":"都道府県","phone":"098-866-2333","suffix":["県",""],"suffix_kana":["ケン",""]},"type":"Feature"},{"geometry":null,"properties":{"surface":"の"},"type":"Feature"},{"geometry":{"coordinates":[],"type":"Point"},"properties":{"address":"大阪府泉南郡南海町","address_level":"3","body":"南海","body_kana":"ナンカイ","code":{"jisx0402":"27364","lasdec":"273643"},"dictionary_id":29,"entry_id":"27364","fullname":"南海町","geonlp_id":"cKm02K","hypernym":["大阪 府","泉南郡"],"kana":"ナンカイチョウ","latitude":"","longitude":"","name":"南海 町","ne_class":"市区町村\/町","suffix":["町",""],"suffix_kana":["チョウ",""],"tel":""},"type":"Feature"},{"geometry":null,"properties":{"surface":"上で台風が発 生しました"},"type":"Feature"}],"type":"FeatureCollection"}}

地名語 が抽出されない場合は、しきい値を変更したり、利用する 地名解析辞書 を追加する必要があります。 しきい値を変更したり、インポート済みの辞書のうちどれを利用するかを指定するには、params の第2パラメータを指定します。詳細は parse オプション を参照してください。

地名解析辞書 をダウンロードしてインポートする手順は GeoNLP 辞書管理ユーティリティ を参照してください。

geonlp_id から地名語を検索する

getGeoInfo メソッドを呼び出すリクエストを作成し、 geonlp_api コマンドで処理します。

$ echo '{"method":"geonlp.getGeoInfo","params":["GzfYzt"],"id":3}' | geonlp_api
{"error":null,"id":3,"result":{"GzfYzt":{"address":"那覇市泉崎1-2-2","body":"沖縄","body_kana":"オキナワ","code":{"jisx0401":"47","lasdec":"470007"},"dictionary_id":28,"entry_id":"47","fullname":"沖縄県","geonlp_id":"GzfYzt","latitude":"26.2133","longitude":"127.67963","ne_class":"都道府県","phone":"098-866-2333","suffix":["県",""],"suffix_kana":["ケン",""]}}}

インストールされている地名解析辞書を調べる

getDictionaries メソッドを呼び出すリクエストを作成し、 geonlp_api コマンドで処理します。

$ echo '{"method":"geonlp.getDictionaries","params":[],"id":4}' | geonlp_api
{"error":null,"id":4,"result":{"26":{"creator":"geonlp","description":"世界の国 ・地域の辞書です。世界的なニュースなどで国名からおおよその場所を知るために利用できます。日本と外交関係のある国の他、同じように用いられる国や地域も一部含みます。\r\n表記は原則として外務省のホームページに従っていますが、「英国」と「イギリス」、「中華人民共和国」と「中国」のように、慣例として使われている表記も登録しています。\r\n位置は首都付近を地図から取得しました。","icon":"https:\/\/geonlp.ex.nii.ac.jp\/icon\/user\/geonlp\/2jP1En.png","identifier":"https:\/\/geonlp.ex.nii.ac.jp\/dictionary\/geonlp\/world_country","internal_id":26,"issued":"2013-09-12 17:47:31","modified":"2013-09-12 17:47:31","record_count":0,"report_count":206,"source":"外務省:各国・地域情勢(http:\/\/www.mofa.go.jp\/mofaj\/area\/)","spatial":[[-175.220000,-41.320000],[179.180000,64.140000]],"subject":["国","国\/自治区","国\/地域"],"title":"世界の国・地域(2013年9月)","url":"https:\/\/geonlp.ex.nii.ac.jp\/dictionary\/geonlp\/world_country\/geonlp_world_country_20130912_u.zip"},"27":{"creator":"geonlp","description":"日本の地方(八地方区分)に、その下位の地域のうち天気予報や新聞記事等でよく利用されるものを追加しました。地方・地域の代表点は特に決まりがないので、おおよその領域の重心付近になるよう、地図から取得しました。\r\n","icon":"https:\/\/geonlp.ex.nii.ac.jp\/icon\/user\/geonlp\/CIq56q.png","identifier":"https:\/\/geonlp.ex.nii.ac.jp\/dictionary\/geonlp\/japan_area","internal_id":27,"issued":"2013-09-12 17:47:45","modified":"2013-09-12 17:47:45","record_count":0,"report_count":26,"source":"Wikipedia「日本の地域」(http:\/\/ja.wikipedia.org\/wiki\/%E6%97%A5%E6%9C%AC%E3%81%AE%E5%9C%B0%E5%9F%9F)\r\n気象 庁「地方予報区」(http:\/\/www.jma.go.jp\/jma\/kishou\/know\/saibun\/index.html )","spatial":[[127.970000,26.590000],[144.250000,44.460000]],"subject":["行政地域\/地域","行政地域\/地方"],"title":"日本の地方・地域(2013年)","url":"https:\/\/geonlp.ex.nii.ac.jp\/dictionary\/geonlp\/japan_area\/geonlp_japan_area_20130912_u.zip"},"28":{"creator":"geonlp","description":"1都1道2府43県の辞書です。県庁 所在地の住所と電話番号を含みます。代表点の座標は県庁の住所をジオコーディングにより取得しています。","icon":"https:\/\/geonlp.ex.nii.ac.jp\/icon\/user\/geonlp\/IjioHK.png","identifier":"https:\/\/geonlp.ex.nii.ac.jp\/dictionary\/geonlp\/japan_pref","internal_id":28,"issued":"2013-09-12 17:47:55","modified":"2013-09-12 17:47:55","record_count":0,"report_count":47,"source":"財団法人地方自治情報センター「都道府県庁」(https:\/\/www.lasdec.or.jp\/cms\/1,69,14,188.html)","spatial":[[127.679630,26.213300],[141.347020,43.064110]],"subject":["都道府県"],"title":"日本の都道府県(2010年4月) ","url":"https:\/\/geonlp.ex.nii.ac.jp\/dictionary\/geonlp\/japan_pref\/geonlp_japan_pref_20130912_u.zip"},"29":{"creator":"geonlp","description":"日本の郡や市区町村の辞書です。昭和57年以降に存在し、現在では統廃合によって消滅した自治体もできる限り収録しています。\r\n役所・役場の所在地、電話番号、地方公共団体コード(6桁)およびJISX0402の自治体コード(5桁)も含みます。これらの情報は、現存する自治体については地方自治情報センターのウェブページより取得し、消滅してしまった郡・市区町村については過去の自治体ウェブサイトやWikipediaの 記述を手がかりに探した情報を組み合わせています。\r\n代表点の座標は、主に役所・役場の住所をジオコーディングにより取得していますが、旧住所などでジオコーディングできないものなど、一部は地図から取得しています。この作業は困難なため、700件以上の 経緯度は空欄のままとなっています。","icon":"https:\/\/geonlp.ex.nii.ac.jp\/icon\/user\/geonlp\/CILaAT.png","identifier":"https:\/\/geonlp.ex.nii.ac.jp\/dictionary\/geonlp\/japan_city","internal_id":29,"issued":"2013-09-12 17:48:04","modified":"2013-09-12 17:48:04","record_count":0,"report_count":4511,"source":"財団法人地方自治情報センター「地方公共団体コード住所」(https:\/\/www.lasdec.or.jp\/cms\/1,0,14.html)","spatial":[[123.004340,24.235430],[145.582700,45.415600]],"subject":["市区町村\/町","市区町村\/市","市区町村\/村","行政地域\/郡","市区町村\/区","市区町村\/特別区","市区町村\/政令市","行政地域\/総合振興局","行政地域\/振興局","行政地域\/支庁"],"title":"日本の郡・市区町村(2013年9月)","url":"https:\/\/geonlp.ex.nii.ac.jp\/dictionary\/geonlp\/japan_city\/geonlp_japan_city_20130912_u.zip"},"30":{"creator":"geonlp","description":"日本の大字の辞書です。2011年調査の 時点で存在した大字を収録しており、過去に消滅したものは含まれていません。\r\n大字名は「街区レベル位置参照情報」および「大字・町丁目位置参照情報」から字名フィールドを選択し、ルールによって大字部分を切り出しています(たとえば「一ツ橋一丁目」という字名から「一ツ橋」)。\r\n代表点の座標は、その大字に含まれる字の代表点を流用しています(たとえば「一ツ橋」の代表点は「一ツ橋一丁目」の座標と同じ)。そのため、大字の領域のやや偏った位置にある場合があります。\r\nisjコードは自治体コード5桁、大字に連番で付与した4桁、字用に追加した3桁の計12桁のコードです。公式なものではないので、将来公式のコードが付与された場合には置き換えられる可能性があります。","icon":"https:\/\/geonlp.ex.nii.ac.jp\/icon\/user\/geonlp\/oZFKnf.png","identifier":"https:\/\/geonlp.ex.nii.ac.jp\/dictionary\/geonlp\/japan_oaza","internal_id":30,"issued":"2013-09-12 17:48:19","modified":"2013-09-12 18:11:20","record_count":0,"report_count":139152,"source":"国土交通省位置参照情報「街区レベル位置参照情報平成23年」「大字・町丁目位置参照情報平成23年」(http:\/\/nlftp.mlit.go.jp\/isj\/)","spatial":[[123.004340,24.060641],[145.796036,45.522159]],"subject":["居住地名\/大字"],"title":"日本の大字(2011年)","url":"https:\/\/geonlp.ex.nii.ac.jp\/dictionary\/geonlp\/japan_oaza\/geonlp_japan_oaza_20130912_u.zip"},"31":{"creator":"geonlp","description":"日本の鉄道駅(地下鉄を含む)の辞書です。hypernym には運営者名と路線名を記載しています。「都営」ではなく「東京都」のようになっていますので注意してください。railway_typeは「鉄道区分コード」、service_provider_typeは「事業者種別コード」です。","icon":"https:\/\/geonlp.ex.nii.ac.jp\/icon\/user\/geonlp\/tTru2O.png","identifier":"https:\/\/geonlp.ex.nii.ac.jp\/dictionary\/geonlp\/japan_station","internal_id":31,"issued":"2013-09-12 17:48:29","modified":"2013-09-12 18:02:32","record_count":0,"report_count":10341,"source":"国土数値 情報「鉄道データ(平成24年度)N02-12」国土交通省(http:\/\/nlftp.mlit.go.jp\/ksj\/gml\/datalist\/KsjTmplt-N02.html)","spatial":[[127.652285,26.193265],[145.597230,45.416163]],"subject":["鉄道施設\/鉄道駅","鉄道施設\/地下鉄駅"],"title":"日 本の鉄道駅(2012年)","url":"https:\/\/geonlp.ex.nii.ac.jp\/dictionary\/geonlp\/japan_station\/geonlp_japan_station_20130912_u.zip"}}}

あるいは list , show を使って確認することもできます。