GET geopoint/spots

指定した地点から一定距離内に存在する観光地情報を取得するAPIです。
レスポンスはJSON文字列で返されます。

Resource URL

https://api.odp.jig.jp/geopoint/spots

Parameters

NameRequiredDescriptionDefaultExample
llrequired観光地を取得する中心地点の緯度と経度をカンマ区切りで指定します。35.878257,136.335057
distanceoptinal中心地点から距離を指定します。単位はメートルです。100km以上の数値を指定した場合は100kmまでの観光地を取得します。20001000
limitoptinal取得する観光地情報の最大個数です。10000以上の値を指定した場合は10000件まで取得します。1001
langoptinal観光地名や説明の言語を指定します。指定できる項目はja(日本語),ko(韓国語),zh-Hant(中国語(繁体字)),zh-Hans(中国語(簡体字)),po(ポルトガル語)の5言語です。jaja
callbackoptinaljsonpで取得する場合のコールバック関数名を指定します。
指定されなかった場合、JSON文字列がそのまま返されます。
callback

Response

FieldTypeDescription
successBoolean正常に取得できたかどうかを返します。trueなら正常、falseなら何らかのエラーが発生したことを示します。
errorsCollection of Stringエラーメッセージの配列を返します。
paramsObject取得時に適用したパラメータを保持するオブジェクトを返します。optionalなパラメータを省略した場合、デフォルトの値が入ります。
resultCollection of Spot観光地情報の配列を返します。
Example:
"result":[{
    "images": ["http://www3.city.sabae.fukui.jp/ls/imagelarge/No24.jpg"],
    "category_note": "まつり活動",
    "distance": 13,
    "latitude": 35.942758,
    "description": "全国シェア80%の生産を占める鯖江の地場産業めがねフレームのシンボル的拠点施設であり、鯖江の高建築物のランドマークです。",
    "type": "http://purl.org/jrrk#CivicPOI",
    "areacode": "http://statdb.nstac.go.jp/lod/sac/C18207",
    "uri": "http://data.city.sabae.lg.jp/rdf/197#%E3%82%81%E3%81%8C%E3%81%AD%E4%BC%9A%E9%A4%A8/%E7%99%BE%E6%99%AF/%E8%A6%B3%E3%82%8B/35.942758/136.198844/",
    "rdf": "http://data.city.sabae.lg.jp/rdf/197",
    "genres": ["観る"],
    "name": "めがね会館",
    "publisher": "福井県鯖江市",
    "category": "百景",
    "longitude": 136.198844
}]

Example Request

https://api.odp.jig.jp/geopoint/spots?ll=35.942995,136.189354&distance=1000&limit=3

Example Response

{
  "result": [
    {
      "images": ["http://www3.city.sabae.fukui.jp/xml/sabakan/simage/t_shopping_951.jpg"],
      "address": "鯖江市日の出町1-2",
      "category_note": "その他",
      "distance": 60,
      "latitude": 35.942997,
      "area_code": "http://statdb.nstac.go.jp/lod/sac/C18207",
      "description": "JR鯖江駅構内にある観光案内所では、鯖江の観光パンフレットや地図などが設置され、鯖江の情報が収集できます。また、ベテランのガイドが常駐しています。気軽にお立ち寄りください。おみやげの販売も行なっています。",
      "telephone": "0778-51-2229",
      "type": "http://purl.org/jrrk#CivicPOI",
      "uri": "http://data.city.sabae.lg.jp/rdf/197#%E8%A6%B3%E5%85%89%E6%A1%88%E5%86%85%E6%89%80/%E8%A6%B3%E5%85%89/%E8%B2%B7%E3%81%86/35.942997/136.188683/",
      "closes": "18:00:00",
      "regularHoliday": "年末年始",
      "rdf": "http://data.city.sabae.lg.jp/rdf/197",
      "genres": ["買う"],
      "name": "観光案内所",
      "opens": "09:00:00",
      "publisher": "福井県鯖江市",
      "openingHours": "9:00~18:00",
      "category": "観光",
      "longitude": 136.188683
    },
    {
      "images": ["http://www3.city.sabae.fukui.jp/ls/imagelarge/No26.jpg"],
      "category_note": "まち",
      "distance": 96,
      "latitude": 35.943357,
      "area_code": "http://statdb.nstac.go.jp/lod/sac/C18207",
      "description": "鯖江市柳町付近のケヤキ並木、そして鯖江市文化センター横の銀杏で、特に三里山を正面に10月下旬の紅葉した銀杏並木と夕焼けに映えた景観はとてもいいです。",
      "type": "http://purl.org/jrrk#CivicPOI",
      "uri": "http://data.city.sabae.lg.jp/rdf/197#%E9%A7%85%E6%9D%B1%E7%B7%9A%E3%81%AE%E8%A1%97%E8%B7%AF%E6%A8%B9/%E7%99%BE%E6%99%AF/%E8%A6%B3%E3%82%8B/35.943357/136.19033/",
      "rdf": "http://data.city.sabae.lg.jp/rdf/197",
      "genres": ["観る"],
      "name": "駅東線の街路樹",
      "publisher": "福井県鯖江市",
      "category": "百景",
      "longitude": 136.19033
    },
    {
      "images": ["http://www3.city.sabae.fukui.jp/xml/sabakan/simage/t_gourmet_013.jpg"],
      "address": "鯖江市日の出町2-1駅前ビル1F",
      "category_note": "スイーツ",
      "distance": 101,
      "latitude": 35.94285,
      "area_code": "http://statdb.nstac.go.jp/lod/sac/C18207",
      "description": "JR鯖江駅を出てすぐ、観光案内所の目の前にある甘味茶屋。時代劇に出てくるような団子屋をイメージしたそう。",
      "telephone": "0778-52-1717",
      "type": "http://purl.org/jrrk#CivicPOI",
      "uri": "http://data.city.sabae.lg.jp/rdf/197#%E6%A5%B5%EF%BC%88%E3%81%8D%E3%82%8F%E3%81%BF%EF%BC%89/%E8%A6%B3%E5%85%89/%E9%A3%9F%E3%81%B9%E3%82%8B/35.94285/136.188244/",
      "closes": "20:00:00",
      "regularHoliday": "木曜日",
      "rdf": "http://data.city.sabae.lg.jp/rdf/197",
      "genres": ["食べる"],
      "name": "極(きわみ)",
      "opens": "10:00:00",
      "publisher": "福井県鯖江市",
      "openingHours": "10:00~20:00",
      "category": "観光",
      "longitude": 136.188244
    }
  ],
  "success": true,
  "params": {
    "ll": "35.942995,136.189354",
    "distance": 1000,
    "limit": 3,
    "lang": "ja"
  }
}