JA:Nominatim

From OpenStreetMap Wiki
Jump to navigation Jump to search

Nominatim (ラテン語で「名前によって」という意味)は、OSMデータを名前や住所で探したり、OSMポイントの住所を合成して生成する(逆ジオコーディング)ツールです。 nominatim.openstreetmap.org で見ることができます。

Nominatim は OpenStreetMap home page のホームページにある検索ボックスの情報源の一つとしても使われています。様々な企業が Nominatim を実行して提供しており、 API を通じてクエリを行うことができます。 例 MapQuest Open Initiative, PickPoint, OpenCage Geocoder, LocationIQ, Geocoding.ai, Geokeo geocoder.

このページではその利用法を説明しています。 Nominatim の動作に関しては開発の概要を参照してください。短いFAQもあります。国別の言語マッピングの一覧や、実験的な国別の住所形式略語の一覧などもあります。

検索結果に問題がありましたら test casesubmitting a bug through trac で情報提供にご協力ください。 Version 2 に関するメモも参照してください。

検索

Nominatim はOSMデータセットの名前付き(あるいは番号付き)の地物や他の名前のない地物(居酒屋、ホテル、教会等)のサブセットに索引を付けます。

検索用語は左から右に処理され、失敗したら右から左に処理されます。

pilkington avenue, birmingham birmingham, pilkington avenue の検索はどちらも成功します。

(カンマはオプションですが、検索の複雑さを減らすことでパフォーマンスを改善します。)

住居番号が設定されている地域では、 135 pilkington avenue, birmingham のように使います。

特別なキーワード

様々なキーワードが特定の OSM タグ(例えば、居酒屋=> amenity=pub)の検索のために翻訳されています。処理できる特殊な句の一覧が利用できます。

引数

 http://nominatim.openstreetmap.org/search?<引数>
 http://nominatim.openstreetmap.org/search/<クエリ>?<引数>

format=[html|xml|json|jsonv2]

出力形式

json_callback=<文字列>

json の出力をラップするコールバック関数(JSONP) 例 <文字列>(<json>)

accept-language=<ブラウザー言語文字列>

検索結果を表示するための言語の優先順位で、 HTTP ヘッダーの "Accept-Language" で指定された値を上書きします。
標準の RFC2616 の accept-language 文字列、または、単純なカンマ区切りの言語コードのリストのどちらかを使ってください。

q=<query>

検索用のクエリ文字列。または、以下のように入力することもできます。

street=<住居番号> <通り名>
city=<都市名>
county=<郡名>
state=<州名>
country=<国名>
postalcode=<郵便番号>

(試験的) 構造的リクエストのための別なクエリ文字列です。
構造的リクエストはより速く、サーバーのリソース消費もより少なくなります。
q=<クエリ> 引数と組み合わせないでください。

countrycodes=<国コード>[,<国コード>][,<国コード>]...

検索結果を特定の国(または国のリスト)に制限します。
<国コード> は ISO-3166-1alpha2 コードで指定します。例えば、イギリスならば gb、ドイツならば de、などです。

viewbox=<左>,<上>,<右>,<下>
または viewboxlbrt=<左>,<下>,<右>,<上>

検索結果を探すために推奨する区域です。

bounded=[0|1]

結果を囲んだ枠の中に含まれているものだけに制限します。
結果を囲んだ枠に制限すると、施設の検索だけが有効になります。
例えば、 "[pub]" だけの検索クエリーはふつうは拒否されますが、 bounded=1 を付けると囲んだ枠の中で一致するものの一覧が結果として得られます。

polygon=[0|1]

見つかったもののポリゴンの輪郭を出力します。
(非推奨、 polygon_* 引数のいずれかを用いてください)

addressdetails=[0|1]

住所の要素への細分化を含む

email=<有効なメールアドレス>

もし大量のリクエストを行う場合は、有効なメールアドレスを含めるか、 User-Agent 文字列の一部にメールアドレスを含めてください。
この情報は秘匿され、問題が発生した場合にあなたに連絡を取るためにのみ使われます。詳細は利用規約を参照してください。

exclude_place_ids=<場所ID,[場所ID],[場所ID]>

検索結果に表示したくない openstreetmap オブジェクトがある場合、スキップしたい場所IDのリストをカンマ区切りで与えます。例えば、以前のクエリーが少ししか結果を返さなかった場合、(可能であれば)ここに含めておけば、検索結果としてそれ以外を返すので、より適切なものになります。

limit=<整数>

返す結果の数を制限します。

dedupe=[0|1]

まだ説明はありません。

debug=[0|1]

まだ説明はありません。

polygon_geojson=1

結果の座標を geojson 形式で出力します。

polygon_kml=1

結果の座標を KML 形式で出力します。

polygon_svg=1

結果の座標を SVG 形式で出力します。

polygon_text=1

結果の座標を WKT 形式で出力します。

extratags=1

可能であれば、結果にウィキペディアへのリンクや営業時間などの追加情報を含めます。

namedetails=1

結果に別名の一覧を含めます。
別な言語の名称、参照記号、運営者名、ブランドが入ることがあります。

 http://nominatim.openstreetmap.org/search?q=135+pilkington+avenue,+birmingham&format=xml&polygon=1&addressdetails=1
 http://nominatim.openstreetmap.org/search/135%20pilkington%20avenue,%20birmingham?format=xml&polygon=1&addressdetails=1
 http://nominatim.openstreetmap.org/search/gb/birmingham/pilkington%20avenue/135?format=xml&polygon=1&addressdetails=1
  <searchresults timestamp="Sat, 07 Nov 09 14:42:10 +0000" querystring="135 pilkington, avenue birmingham" polygon="true">
    <place 
      place_id="1620612" osm_type="node" osm_id="452010817" 
      boundingbox="52.548641204834,52.5488433837891,-1.81612110137939,-1.81592094898224" 
      polygonpoints="[['-1.81592098644987','52.5487429714954'],['-1.81592290792183','52.5487234624632'],...]" 
      lat="52.5487429714954" lon="-1.81602098644987" 
      display_name="135, Pilkington Avenue, Wylde Green, City of Birmingham, West Midlands (county), B72, United Kingdom" 
      class="place" type="house">
      <house_number>135</house_number>
      <road>Pilkington Avenue</road>
      <village>Wylde Green</village>
      <town>Sutton Coldfield</town>
      <city>City of Birmingham</city>
      <county>West Midlands (county)</county>
      <postcode>B72</postcode>
      <country>United Kingdom</country>
      <country_code>gb</country_code>
    </place>
  </searchresults>
 http://nominatim.openstreetmap.org/search/Unter%20den%20Linden%201%20Berlin?format=json&addressdetails=1&limit=1&polygon_svg=1
[
    {
        "address": {
            "city": "Berlin",
            "city_district": "Mitte",
            "construction": "Unter den Linden",
            "continent": "European Union",
            "country": "Deutschland",
            "country_code": "de",
            "house_number": "1",
            "neighbourhood": "Scheunenviertel",
            "postcode": "10117",
            "public_building": "Kommandantenhaus",
            "state": "Berlin",
            "suburb": "Mitte"
        },
        "boundingbox": [
            "52.5170783996582",
            "52.5173187255859",
            "13.3975105285645",
            "13.3981599807739"
        ],
        "class": "amenity",
        "display_name": "Kommandantenhaus, 1, Unter den Linden, Scheunenviertel, Mitte, Berlin, 10117, Deutschland, European Union",
        "importance": 0.73606775332943,
        "lat": "52.51719785",
        "licence": "Data \u00a9 OpenStreetMap contributors, ODbL 1.0. http://www.openstreetmap.org/copyright",
        "lon": "13.3978352028938",
        "osm_id": "15976890",
        "osm_type": "way",
        "place_id": "30848715",
        "svg": "M 13.397511 -52.517283599999999 L 13.397829400000001 -52.517299800000004 13.398131599999999 -52.517315099999998 13.398159400000001 -52.517112099999999 13.3975388 -52.517080700000001 Z",
        "type": "public_building"
    }
]


 http://nominatim.openstreetmap.org/?format=json&addressdetails=1&q=[bakery]+berlin+wedding&format=json&limit=1
[
    {
        "address": {
            "bakery": "B\u00e4cker Kamps",
            "city_district": "Mitte",
            "continent": "European Union",
            "country": "Deutschland",
            "country_code": "de",
            "footway": "Bahnsteig U6",
            "neighbourhood": "Sprengelkiez",
            "postcode": "13353",
            "state": "Berlin",
            "suburb": "Wedding"
        },
        "boundingbox": [
            "52.5460929870605",
            "52.5460968017578",
            "13.3591794967651",
            "13.3591804504395"
        ],
        "class": "shop",
        "display_name": "B\u00e4cker Kamps, Bahnsteig U6, Sprengelkiez, Wedding, Mitte, Berlin, 13353, Deutschland, European Union",
        "icon": "http://nominatim.openstreetmap.org/images/mapicons/shopping_bakery.p.20.png",
        "importance": 0.201,
        "lat": "52.5460941",
        "licence": "Data \u00a9 OpenStreetMap contributors, ODbL 1.0. http://www.openstreetmap.org/copyright",
        "lon": "13.35918",
        "osm_id": "317179427",
        "osm_type": "node",
        "place_id": "1453068",
        "type": "bakery"
    }
]

逆ジオコーディング

逆ジオコーディングは緯度経度から住所を生成します。オプションの zoom 引数は Leaflet.js/OpenLayers などのズームレベル用に適したものに関して必要とされる詳細さのレベルを指定します。

引数

 http://nominatim.openstreetmap.org/reverse?<クエリ>

format=[xml|json]

出力形式

json_callback=<文字列>

json の出力をラップするコールバック関数(JSONP) 例 <文字列>(<json>)

accept-language=<ブラウザー言語文字列>

検索結果を表示するための言語の優先順位で、 HTTP ヘッダーの "Accept-Language" で指定された値を上書きします。
標準の RFC2616 の accept-language 文字列、または、単純なカンマ区切りの言語コードのリストのどちらかを使ってください。

osm_type=[N|W|R]
osm_id=<値>

住所を返す特定のOSMのノード/ウェイ/リレーション
できるだけ lat/lon よりもこちらを優先して使ってください

lat=<value> lon=<value>

住所を生成する座標

zoom=[0-18]

必須となる詳細さのレベルで、 0 は国レベル、 18 は家/建物レベル

addressdetails=[0|1]

要素内で細分化した住所を含む

email=<有効なメールアドレス>

もし大量のリクエストを行う場合は、有効なメールアドレスを含めるか、 User-Agent
文字列の一部にメールアドレスを含めてください。
この情報は秘匿され、問題が発生した場合にあなたに連絡を取るためにのみ使われます。
詳細は利用規約を参照してください。

polygon_geojson=1

結果の座標を geojson 形式で出力します。

polygon_kml=1

結果の座標を KML 形式で出力します。

polygon_svg=1

結果の座標を SVG 形式で出力します。

polygon_text=1

結果の座標を WKT 形式で出力します。

extratags=1

可能であれば、結果にウィキペディアへのリンクや営業時間などの追加情報を含めます。

namedetails=1

結果に別名の一覧を含めます。
別な言語の名称、参照記号、運営者名、ブランドが入ることがあります。

 http://nominatim.openstreetmap.org/reverse?format=xml&lat=52.5487429714954&lon=-1.81602098644987&zoom=18&addressdetails=1
  <reversegeocode timestamp="Fri, 06 Nov 09 16:33:54 +0000" querystring="...">
    <result place_id="1620612" osm_type="node" osm_id="452010817">
      135, Pilkington Avenue, Wylde Green, City of Birmingham, West Midlands (county), B72, United Kingdom
    </result>
    <addressparts>
      <house_number>135</house_number>
      <road>Pilkington Avenue</road>
      <village>Wylde Green</village>
      <town>Sutton Coldfield</town>
      <city>City of Birmingham</city>
      <county>West Midlands (county)</county>
      <postcode>B72</postcode>
      <country>United Kingdom</country>
      <country_code>gb</country_code>
    </addressparts>   
  </reversegeocode>

階層構造

管理レベル XML エンティティ
2 <国>
4 <州>
5 <州内の地方>
6
7 <郡>
8 <村>
9 <都市内の地方>
10 <地区>


住所ルックアップ

1つ以上のノード、ウェイ、リレーションのような OSM オブジェクトの住所をルックアップします。

引数

 http://nominatim.openstreetmap.org/lookup?<query>

format=[xml|json]

出力形式

json_callback=<文字列>

json の出力をラップするコールバック関数(JSONP) 例 <文字列>(<json>)

accept-language=<ブラウザー言語文字列>

検索結果を表示するための言語の優先順位で、 HTTP ヘッダーの "Accept-Language" で指定された値を上書きします。
標準の RFC2616 の accept-language 文字列、または、単純なカンマ区切りの言語コードのリストのどちらかを使ってください。

osm_ids=[N|W|R]<値>,…,[N|W|R]<値>

住所を返す対象となる OSM のノード、ウェイ、リレーションの ID 50件以下のリスト

addressdetails=[0|1]

要素内で細分化した住所を含む

email=<有効なメールアドレス>

もし大量のリクエストを行う場合は、有効なメールアドレスを含めるか、 User-Agent 文字列の一部にメールアドレスを含めてください。
この情報は秘匿され、問題が発生した場合にあなたに連絡を取るためにのみ使われます。詳細は利用規約を参照してください。

extratags=1

可能であれば、結果にウィキペディアへのリンクや営業時間などの追加情報を含めます。

namedetails=1

結果に別名の一覧を含めます。
別な言語の名称、参照記号、運営者名、ブランドが入ることがあります。

 http://nominatim.openstreetmap.org/lookup?osm_ids=R146656,W104393803,N240109189
  <lookupresults timestamp="Mon, 29 Jun 15 18:01:33 +0000" attribution="Data © OpenStreetMap contributors, ODbL 1.0. http://www.openstreetmap.org/copyright" querystring="R146656,W104393803,N240109189" polygon="false">
    <place place_id="127761056" osm_type="relation" osm_id="146656" place_rank="16" lat="53.4791466" lon="-2.2447445" display_name="Manchester, Greater Manchester, North West England, England, United Kingdom" class="boundary" type="administrative" importance="0.704893333438333">
      <city>Manchester</city>
      <county>Greater Manchester</county>
      <state_district>North West England</state_district>
      <state>England</state>
      <country>United Kingdom</country>
      <country_code>gb</country_code>
    </place>
    <place place_id="77769745" osm_type="way" osm_id="104393803" place_rank="30" lat="52.5162024" lon="13.3777343363579" display_name="Brandenburg Gate, 1, Pariser Platz, Mitte, Berlin, 10117, Germany" class="tourism" type="attraction" importance="0.443472858361592">
      <attraction>Brandenburg Gate</attraction>
      <house_number>1</house_number>
      <pedestrian>Pariser Platz</pedestrian>
      <suburb>Mitte</suburb>
      <city_district>Mitte</city_district>
      <city>Berlin</city>
      <state>Berlin</state>
      <postcode>10117</postcode>
      <country>Germany</country>
      <country_code>de</country_code>
    </place>
    <place place_id="2570600569" osm_type="node" osm_id="240109189" place_rank="15" lat="52.5170365" lon="13.3888599" display_name="Berlin, Germany" class="place" type="city" importance="0.822149797630868">
      <city>Berlin</city>
      <state>Berlin</state>
      <country>Germany</country>
      <country_code>de</country_code>
    </place>
  </lookupresults>

詳細 / 地名索引

現在のところ、詳細ページ(details.php)はサーバに高い負荷をかけるので、デバッグ支援用途の位置づけとなっています。このため XML API は現在提供されていません。大量使用や高負荷をかけると IP が拒否される場合があります。

利用ポリシー

nominatim.openstreetmap.org の利用ポリシーは Nominatim usage policy を参照してください(訳注:外部サイトへ移動しました)。

MapQuest もこの API のあるバージョンを異なる利用条件で提供しています。 API キーが必要で、「無料」の連続利用は月当たり15,000リクエストまで許されています。詳細は [1] を参照してください。

ソースコード

Nominatim は代替的な地名索引オプションを使った postgresql へのインポートユーティリティを使用した osm2pgsql などをベースにしています。インデックス化と検索は C、 plpgsql、 php の組み合わせで実行されています。ソースコードはこちらにあります。

https://github.com/twain47/Nominatim

インストール手順の全体は Nominatim/Installation にあります(訳注:外部サイトへ移動しました)。

バグ/エラー報告

Nominatim は Twain がメンテナンスしています、Nominatim コンポーネント使用上のバグは Trac で報告してください。