地図情報発信基盤
API 利用書Ver.1.1

目次

はじめに.............................................................................................................................................. 3
地図情報発信基盤で扱うデータの構成.......................................................................................... 4
ジャンル..........................................................................................................................................5
施設................................................................................................................................................. 6

地図情報発信基盤で利用できる Web API....................................................................................... 8lang パラメータ...................................................................................................................................9
ジャンル取得 API............................................................................................................................. 10
施設検索 API..................................................................................................................................... 12
施設情報取得 API............................................................................................................................. 14
補足.................................................................................................................................................... 16

1. はじめに本利用書は、地図情報発信基盤に登録された金沢市内の施設情報を取得するために用意された Web API の利用方法についてまとめたものです。

2. 地図情報発信基盤で扱うデータの構成

地図情報発信基盤では、施設と施設が属するジャンルを扱います。

ジャンル

2.1.

地図情報発信基盤に登録されている施設は１つ以上のジャンルに属します。複数のサブジャンルを持つジャンルがあります。

オブジェクト名

genre
データ項目

id

ジャンル ID

name

ジャンル名

subgenres

サブジャンル（複数あり）

オブジェクト名

subgenreデータ項目

id
name

サブジャンルID
サブジャンル名

2.2.

施設

地図情報発信基盤に登録されている施設の情報です。
オブジェクト名

facility

データ項目

id
genresnamesummary
zipcodeaddress
coordinates
tel
fax
email
opening_hours
closed_days
fee
note
url
medias

施設ID

ジャンル（複数あり）
名称
概略

郵便番号
住所
位置

電話番号

Fax番号

メールアドレス
時間

休館日
料金
備考

リンク

施設関連の画像など（複数あり）

オブジェクト名

coordinates
データ項目

latitudelongitude

緯度
経度

オブジェクト名

media

データ項目

imagesmoviesaudios

画像（複数あり）映像（複数あり）
音声（複数あり）オブジェクト名

image

データ項目

sourcethumbnail

画像ファイルのURL
サムネイルファイルのURL

オブジェクト名

movie

データ項目

source

映像ファイルのURL

オブジェクト名

audio

データ項目

source

音声ファイルのURL

3. 地図情報発信基盤で利用できる Web API
地図情報発信基盤では以下の Web API が利用できます。
•••

ジャンル情報取得 API
施設検索 API
施設情報取得 API

4. lang パラメータ
各 API にはレスポンスの言語を指定できる lang パラメータが用意されています。指定しなければ、英語(lang=en）が指定されてたことになります。各言語環境に合わせて、下記パラメー
タ値を指定してください。
ただし、指定言語の情報がない場合は英語、英語情報がなければ日本語の情報がレスポンスとして返されます。

lang パラメータ値
en

英語

ja

日本語

zh-Hans

中国語（簡体）zh-Hant

中国語（繁体）

ko

韓国語

fr

フランス語

pt

ポルトガル語esスペイン語

lang パラメータ指定例(スペイン語指定)
https://infra-api.city.kanazawa.ishikawa.jp/v1/facilities/search.json?lang=es

5. ジャンル取得 API

ジャンルの一覧を取得できます。
ジャンルは更新されることがあります。ジャンル情報を利用する場合は適宜取得し直してください。

リクエスト URL

https://infra-api.city.kanazawa.ishikawa.jp/v1/genres/list.json
HTTP メソッド
GET
リクエストパラメータ

lang

レスポンスの言語
例. ja

リクエスト例https://infra-api.city.kanazawa.ishikawa.jp/v1/genres/list.json
レスポンス例※URL デコードしたものを表示しています。

{"genres": [{"id": "1","name": "観光","subgenres": [{"id": 1,"name": "美術館・博物館"},{"id": 2,"name": "歴史・文化施設"},{"id": 3,"name": "寺社"},{"id": 4,"name": "庭園・公園"},

{"id": 5,"name": "その他"}]}]}

6. 施設検索 API
位置(緯度経度)やキーワードなどから施設を検索できます。より詳細な施設情報を取得したい場合は「7. 施設情報取得 API」を参照してください。

リクエストURL

https://infra-api.city.kanazawa.ishikawa.jp/v1/facilities/search.json
HTTPメソッド
GET
リクエストパラメータ

lang

レスポンスの言語例. ja

geocode検索範囲(中心緯度[°],中心経度[°],半径[m])例. 36.5946816,136.6255726,2000

genre

施設のジャンル例(ジャンルのみ). 3
例(サブジャンルも指定). 3-2例(複数ジャンル指定). 3-2,4,5-1

keyword

施設情報(名称、概略、備考)に含まれる文言
例. 金沢

count

最大取得件数例. 20

リクエスト例https://infra-api.city.kanazawa.ishikawa.jp/v1/facilities/search.json?
lang=ja&geocode=36.5946816,136.6255726,2000
レスポンス例※URL デコードしたものを表示しています。
{"facilities": [{"address": "金沢市広坂 1-1-1","coordinates": {"latitude": 36.561051,"longitude": 136.656633},"detail_url": "http://infraapi.city.kanazawa.ishikawa.jp/facilities/1.json?lang=ja","genres": [{"id": 4,"name": "くらし","subgenre": {"id": 8,
"name": "届け出・証明"}}],"id": "1","name": "市役所本庁舎","tel": "076-220-2111","url": ""}],"next_page": "http://infraapi.city.kanazawa.ishikawa.jp/facilities/search.json?
lang=ja&page=2&count=20","page": 1}

7. 施設情報取得 API

指定の施設の情報を取得できます。

リクエストURL

https://infra-api.city.kanazawa.ishikawa.jp/v1/facilities/:id.json
HTTPメソッド
GET
リクエストパラメータ

id

施設ID

lang

レスポンスの言語
例. ja

リクエスト例https://infra-api.city.kanazawa.ishikawa.jp/v1/facilities/1.json
レスポンス例※URL デコードしたものを表示しています。
{"facility": {"address": "金沢市広坂 1-1-1","closed_days": "土・日・祝日、年末年始(12/29～1/3)(自動交付機は 12/31～1/3 のみ休止)","coordinates": {"latitude": 36.561051,"longitude": 136.656633},"email": "","fax": "","fee": "","genres": [{"id": 4,
"name": "くらし","subgenre": {"id": 8,
"name": "届け出・証明"}}],"id": "1","medias": {"audios": [],"images": [],"videos": []},"name": "市役所本庁舎","note": "","opening_hours": "9:00～17:45(自動交付機：平日 9:00～19:00、土・日・祝日 9:00～17:00)","summary": "主な取扱業務
各種証明書の交付
戸籍・住民異動届の受付
国民健康保険の加入・脱退
住民票・印鑑登録証明書の自動交付サービス","tel": "076-220-2111","url": "","zipcode": "920-8577"}}
備考
施設 ID を指定して直接この API を呼び出すことは推奨しません。「施設の検索 API」を呼び出し、レスポンス内の detail_url をリクエストしてください。

8. 補足8.1.

クロスドメインでの API の利用

クロスドメインで API を利用する際には JSONP が使用できます。URI の拡張子 json をjsonp にし、callback パラメータに呼び出す関数名を記述して下さい。
例. https://infra-api.city.kanazawa.ishikawa.jp/v1/facilities/1.jsonp?callback=response