スポット検索
/spot [GET]
基本情報
概要
キーワードを指定して条件に合致するスポットの一覧を取得します。
スポットとは下記のような施設全般を指します。
- 飲食店、医療機関、娯楽施設、宿泊施設、小売店、公共施設、観光地 など
※当APIをご利用の場合は、専用データ利用のオプション契約が別途必要となります
禁止事項
本APIで取得した駐車場データについて、データ提供元により許諾されていないため、
駐車場料金の安い順で表示することはお控えください。
URL
https://{HOST}/{CID}/v1/spot
※APIマーケットでは提供しておりません
出力形式
- JSON
対応言語
- ja, en, ko, zh-CN, zh-TW, th
出力順
- 検索ワードの類似度と検索のランキングを考慮した株式会社ナビタイムジャパン独自のスコア降順
- 緯度経度を指定した場合は指定緯度経度からの距離昇順
スコアについて
スコアは順番が常に最適になるよう変動していますので、ご要望などによる順番変更はできません
パラメータ
| パラメータ名 | 必須 | 概要 | 型名 | デフォルト値 | 上下限/選択値 | 備考 |
|---|---|---|---|---|---|---|
| word | ✔ | 検索ワード | 文字列 | 検索したいスポット名称 ・スポットのふりがなも指定可能です ・二単語以上で検索すると、「駅周辺検索」が行われます （例）「渋谷 映画」 → 「渋谷駅近くの映画館」が検索されます |
||
| address_filter | 住所フィルター | 文字列 | 住所を絞り込むフィルター 住所コード(code)を指定する ・指定コードによる絞り込み:address_filter=code ・指定コードの除外：address_filter=-code ・複数指定の場合は、上記指定を「.」区切りで指定 |
|||
| category_filter | カテゴリフィルター | 文字列 | カテゴリを絞り込むフィルター カテゴリコード(code)を指定する ・指定コードによる絞り込み:category_filter=code ・指定コードの除外：category_filter=-code ・複数指定の場合は、上記指定を「.」区切りで指定 |
|||
| coord | 検索基点 | カンマ区切りの数値 | 検索を行う基準地点の緯度経度 ・「緯度,経度」の順で指定 ・ミリ秒表記、度表記(10進数)に対応 |
|||
| radius | 検索範囲の半径(単位：m) | 数値 | 2000 | 最大値：100000 | coord指定時のみ使用可能 | |
| consider_distance | 距離の考慮 | 真偽値 | false | true：考慮する false：考慮しない |
距離を出力順序のスコアリングに反映させるかどうかを指定します 以下の場合はエラーとなります ・coordを指定していない場合 ・radiusと同時指定した場合(詳細はこちらをご覧ください) |
|
| limit | データの出力件数 | 数値 | 10 | 最小値：1 最大値：100 |
スポットデータの出力数 | |
| opening_time | 営業時間 | 文字列（日付時刻） YYYY-MM-DDThh:mm:ss |
現在時刻 | 「対象スポットが指定した日時に営業しているかどうか」がレスポンスに付与されます 「options=opening_hours」指定時かつ営業時間に関するデータが存在する場合のみ出力します opening_time未指定時は現在時刻を指定します |
||
| additional_filter | 付加条件 | 文字列 | cvs_for_large_car：乗用車以外も駐車可能なコンビニ | スポットに関する特定の条件を指定します 詳細はこちらをご覧ください |
||
| offset | データの出力開始位置 | 数値 | 0 | 最小値：0 最大値：2000 |
何件目から表示されるか(1件目が0)を指定します | |
| options | 追加出力情報 | 文字列 | exact_coord：スポット到着地点 detail：詳細情報 opening_hours：営業時間情報 |
追加で出力する情報 ・ピリオド区切りで複数指定可能 ※exact_coordはD2Dオプション申込時のみ利用可能 |
||
| lang | 言語 | 文字列 | ja: 日本語 en: 英語 ko: 韓国語 zh-CN: 中国語(簡体字) zh-TW: 中国語(繁体字) th: タイ語 |
出力する言語を指定します ・ピリオド区切りで複数指定可能 ※多言語オプション申込時のみ利用可能 |
||
| datum | 緯度経度の測地系 | 文字列 | wgs84 | wgs84：世界測地系 tokyo：旧日本測地系 |
||
| coord_unit | 出力データに含まれる緯度経度の単位 | 文字列 | degree | degree：度表記の10進法 millisec：ミリ秒表記 |
consider_distanceとradiusの違いについて
consider_distanceを指定した場合とradiusを指定した場合では、検索方法に以下のような違いがあります。
radiusを指定した場合：検索範囲を指定した検索が可能。
consider_distanceを指定した場合：検索範囲は全国として、指定したcoordから検索対象スポットまでの距離の近さを考慮した検索が可能。ただし検索ワード等を加味して総合的な判断を行うため、必ずしも距離が近い順に出力されるわけではありません。
additional_filterについて
● 乗用車以外も駐車可能なコンビニ
本データは、ナビタイムジャパン独自整備のデータです。
普通車・軽自動車以外の駐車スペースがあるコンビニエンスストアを検索可能です（二輪車は含みません）。
langパラメータの指定時の注意点
・多言語に対応したレスポンスはMultilingualオブジェクトとして出力されることにご注意ください。
・一部スポットは多言語データが存在しないため、多言語指定時には返却されない場合があります。
・詳細情報がある場合、langで指定した1番目の言語でのみ返却されます。
パラメータ構成例
- 中目黒周辺で検索ワード「ピザ」で10件検索
/spot?coord=35.644377,139.699012&word=ピザ
レスポンス
| 名称 | レスポンス名 | 型名 | 配列 | 説明 |
|---|---|---|---|---|
| 検索数 | count | Countオブジェクト | レスポンスのヒット数などの情報 | |
| スポット情報 | items | Spotオブジェクト | 〇 | スポット情報のまとまり |
| 単位情報 | unit | Unitオブジェクト | 出力される単位の情報 |
Countオブジェクト
| 名称 | レスポンス名 | 型名 | 配列 | 説明 |
|---|---|---|---|---|
| トータルヒット件数 | total | 数値 | 検索ヒットした件数 | |
| オフセット値 | offset | 数値 | オフセットが設定されている場合はその値を出力 | |
| データの出力件数 | limit | 数値 | データの出力件数に設定されている値 1件しかヒットしなかった場合でも、limit=10でリクエストしている場合は10と出力 |
Spotオブジェクト
| 名称 | レスポンス名 | 型名 | 配列 | 説明 |
|---|---|---|---|---|
| スポットコード | code | 文字列 | ||
| スポット名 | name | 文字列/Multilingualオブジェクト | langパラメータ指定時は、Multilingualオブジェクトで出力 | |
| スポット名の読み仮名 | ruby | 文字列/Multilingualオブジェクト | langパラメータ指定時は、Multilingualオブジェクトで出力 ただし"ja"を含む場合のみ(日本語のみ) |
|
| 電話番号 | phone | 文字列 | 表示用電話番号 ハイフン区切りの電話番号 |
|
| 住所コード | address_code | 文字列 | ||
| 住所の表示名 | address_name | 文字列/Multilingualオブジェクト | langパラメータ指定時は、Multilingualオブジェクトで出力 | |
| 緯度経度 | coord | Coordinateオブジェクト | ||
| 距離(単位：m) | distance | 数値 | 検索基点からの距離 パラメータ「coord」指定時のみ出力 |
|
| 郵便番号 | postal_code | 文字列 | ||
| カテゴリ一覧 | categories | Categoryオブジェクト | 〇 | |
| 道路情報 | road_info | RoadInfoオブジェクト | データが存在する場合のみ出力 | |
| サブカテゴリ情報 | subcategories | SubCategoryオブジェクト | 〇 | |
| 詳細情報 | details | SpotDetailオブジェクト | 〇 | パラメータ「options=detail」指定時かつデータが存在する場合のみ出力 出力優先度を考慮してソートされています |
| スポット到着地点の緯度経度 | exact_coord | SpotExactCoordオブジェクト | パラメータ「options=exact_coord」指定時かつデータが存在する場合のみ出力 | |
| 営業時間情報 | opening_hours | SpotOpeningHoursオブジェクト | パラメータ「options=opening_hours」指定時かつデータが存在する場合のみ出力 | |
| 付加条件の対応フラグ | additional | 文字列 | ◯ | パラメータ「additional_filter」の値に紐づいているスポットのみ出力されます 乗用車以外も駐車可能なコンビニ |
Multilingualオブジェクト
| 名称 | レスポンス名 | 型名 | 配列 | 説明 |
|---|---|---|---|---|
| 英語名称 | en | 文字列 | ||
| 日本語名称 | ja | 文字列 | ||
| 韓国語名称 | ko | 文字列 | ||
| タイ語名称 | th | 文字列 | ||
| 中国語(簡体字)名称 | zh-CN | 文字列 | ||
| 中国語(繁体字)名称 | zh-TW | 文字列 |
Coordinateオブジェクト
| 名称 | レスポンス名 | 型名 | 配列 | 説明 |
|---|---|---|---|---|
| スポットの緯度 | lat | 数値 | ||
| スポットの経度 | lon | 数値 |
Categoryオブジェクト
| 名称 | レスポンス名 | 型名 | 配列 | 説明 |
|---|---|---|---|---|
| カテゴリコード | code | 文字列 | ||
| カテゴリ名 | name | 文字列/Multilingualオブジェクト | langパラメータ指定時は、Multilingualオブジェクトで出力 | |
| カテゴリ名の読み仮名 | ruby | 文字列/Multilingualオブジェクト | langパラメータ指定時は、Multilingualオブジェクトで出力 ただし"ja"を含む場合のみ返却(日本語のみ) |
|
| カテゴリコードのレベル | level | 文字列 | large, middle, small, detail の４階層 |
SubCategoryオブジェクト
| 名称 | レスポンス名 | 型名 | 配列 | 説明 |
|---|---|---|---|---|
| カテゴリ一覧 | - | Categoryオブジェクト | 〇 | レスポンス名なし Categoryオブジェクトの配列 |
サブカテゴリについて
「薬局」系のスポットは「病院/医療」や「生活雑貨/日用品」といった複数カテゴリに分類され、代表カテゴリ以外のものがサブカテゴリとしてここに出力されます。
代表カテゴリの選定は株式会社ナビタイムジャパンにて独自に行っており、変更はできません。
また、カテゴリ指定時はこれら全てのものが検索対象となります。
RoadInfoオブジェクト
| 名称 | レスポンス名 | 型名 | 配列 | 説明 |
|---|---|---|---|---|
| 道路種別の名称 | name | 文字列/Multilingualオブジェクト | 値は常に"有料道路"が出力されます langパラメータ指定時は、Multilingualオブジェクトで出力 |
SpotDetailオブジェクト
| 名称 | レスポンス名 | 型名 | 配列 | 説明 |
|---|---|---|---|---|
| フラグ情報 | flags | BooleanItemオブジェクト | 〇 | データが存在する場合のみ出力 |
| テキスト情報 | texts | TextItemオブジェクト | 〇 | データが存在する場合のみ出力 多言語指定時はlangパラメータで指定した最初の言語でのみ出力 |
| 駐車場の満空情報 | parking_status | ParkingStatusオブジェクト | データが存在する場合のみ出力 | |
| 大型車専用駐車場の満空情報 | large_car_parking_status | ParkingStatusオブジェクト | データが存在する場合のみ出力 | |
| 日付情報 | dates | TextItemオブジェクト | 〇 | データが存在する場合のみ出力 |
| 宣伝情報 | copies | TextItemオブジェクト | 〇 | データが存在する場合のみ出力 |
| URL情報 | urls | TextItemオブジェクト | 〇 | データが存在する場合のみ出力 |
| 駐車場の静的な情報 | parking | Parkingオブジェクト | データが存在する場合のみ出力 |
BooleanItemオブジェクト
| 名称 | レスポンス名 | 型名 | 配列 | 説明 |
|---|---|---|---|---|
| 見出し | label | 文字列 | ||
| 真偽値 | value | 真偽値 |
TextItemオブジェクト
| 名称 | レスポンス名 | 型名 | 配列 | 説明 |
|---|---|---|---|---|
| 見出し | label | 文字列 | ||
| 文字列値 | value | 文字列 | ||
| 項目ID | id | 文字列 |
ParkingStatusオブジェクト
| 名称 | レスポンス名 | 型名 | 配列 | 説明 |
|---|---|---|---|---|
| ステータスコード | code | 文字列 | 下記のうちいずれかの数字が格納されます 0 - 空 1 - 混雑 2 - 満車 3 - 閉鎖 7 - 不明 「不明」はセンサーの障害やお祭りなどで利用できない状態を表します |
|
| 状態を表す文字列 | text | 文字列 | ステータスコードによって出力される文字列が異なります 0 - 空 1 - 混雑 2 - 満車 3 - 閉鎖 7 - 不明 「不明」はセンサーの障害やお祭りなどで利用できない状態を表します |
|
| データ更新時刻 | update_time | 文字列 |
Parkingオブジェクト
| 名称 | レスポンス名 | 型名 | 配列 | 説明 |
|---|---|---|---|---|
| 車両に関する制限 | car_regulation | ParkingCarRegulationオブジェクト | ||
| 充電の可否 | chargeable | 真偽値 | ||
| 駐車可能台数 | capacity | 数値 | ||
| 駐車場の形式 | building_type | 文字列 | 〇 | flat：平地 solid：立体 underground：地下 machine：機械式 |
| 料金支払い方法 | payment_method | 文字列 | 〇 | bill：紙幣 credit：クレジットカード e_money：電子マネー |
| 領収書の有無 | receipt | 真偽値 | 領収書がある場合のみtrueが出力されます |
ParkingCarRegulationオブジェクト
| 名称 | レスポンス名 | 型名 | 配列 | 説明 |
|---|---|---|---|---|
| 最大車高(cm) | height | 数値 | ||
| 最大車幅(cm) | width | 数値 | ||
| 最大車長(cm) | length | 数値 | ||
| 最大車重(kg) | weight | 数値 | ||
| 車種制限 | car_type | 文字列 | 〇 | 3number：3ナンバー制限 5number：5ナンバー制限 imported：外車制限 rv：RV制限 1box：1ボックス制限 |
SpotExactCoordオブジェクト
| 名称 | レスポンス名 | 型名 | 配列 | 説明 |
|---|---|---|---|---|
| 車向け到着地点緯度経度 | car | SpotExactCoordPointオブジェクト | 〇 | データに入っている場合のみ出力 |
| 徒歩向け到着地点緯度経度 | walk | SpotExactCoordPointオブジェクト | 〇 | データに入っている場合のみ出力 |
SpotExactCoordPointオブジェクト
| 名称 | レスポンス名 | 型名 | 配列 | 説明 |
|---|---|---|---|---|
| 地点名称 | name | 文字列/Multilingualオブジェクト | langパラメータ指定時は、Multilingualオブジェクトで出力 | |
| 緯度経度 | coord | Coordinateオブジェクト | ||
| 識別番号 | seq | 数値 | ・地点名称が同一の場合があり、その識別用 |
識別番号について
識別番号は、1つの到着地点緯度経度に対し任意の番号を割り当てております。
同じ緯度経度でこの番号が変わることはございません。また、同じスポット内で番号が重複することもございません。
今後、到着地点緯度経度の地点名称の変更や、到着地点緯度経度が追加・削除となる場合もございますので、差分確認などにご利用ください。
SpotOpeningHoursオブジェクト
| 名称 | レスポンス名 | 型名 | 配列 | 説明 |
|---|---|---|---|---|
| 指定した時間の営業フラグ | open | 真偽値 | true：opening_timeで指定した時刻が営業時間内の場合 false： opening_timeで指定した時刻が営業時間外の場合 |
|
| 24時間営業であることを示すフラグ | open24h | 真偽値 | 24時間営業であればtrue | |
| 営業時間情報一覧 | schedule | SpotOpeningHoursScheduleオブジェクト | ○ |
SpotOpeningHoursScheduleオブジェクト
| 名称 | レスポンス名 | 型名 | 配列 | 説明 |
|---|---|---|---|---|
| 曜日ID | day_id | 文字列 | 01：月曜日 02：火曜日 03：水曜日 04：木曜日 05：金曜日 06：土曜日 07：日曜日 11：祝日 |
|
| 休業日フラグ | close | 真偽値 | 休業日であればtrue 休業日が不明の場合は表示されません |
|
| 指定した日時に該当する曜日を示すフラグ | applied | 真偽値 | opening_timeパラメータで指定した日時に該当する曜日のオブジェクトだった場合にtrueが出力されます 該当する曜日以外の場合は表示されません |
|
| 営業時間 | periods | SpotOpeningHoursPeriodオブジェクト | ○ |
SpotOpeningHoursPeriodオブジェクト
| 名称 | レスポンス名 | 型名 | 配列 | 説明 |
|---|---|---|---|---|
| 営業開始時間 | open_time | 文字列 | ||
| 営業終了時間 | close_time | 文字列 |
Unitオブジェクト
| 名称 | レスポンス名 | 型名 | 配列 | 説明 |
|---|---|---|---|---|
| 緯度経度の測地系 | datum | 文字列 | ||
| 緯度経度の出力形式 | coord_unit | 文字列 |
レスポンス例
{
"count": {
"total": 29,
"offset": 0,
"limit": 10
},
"items": [
{
"code": "02108-7694",
"name": "ピッツァマンロケット",
"ruby": "ぴっつぁまんろけっと",
"phone": "0363030048",
"address_name": "東京都目黒区上目黒1-20-10",
"address_code": "13110005000",
"coord": {
"lat": 35.644858,
"lon": 139.698646
},
"distance": 63,
"postal_code": "1530051",
"categories": [
{
"code": "0306004001",
"name": "ピザ",
"ruby": "ぴざ",
"level": "detail"
},
{
"code": "0306004",
"name": "ピザ",
"ruby": "ぴざ",
"level": "small"
},
{
"code": "0306",
"name": "洋食系/西洋料理",
"ruby": "ようしょくけいせいようりょうり",
"level": "middle"
},
{
"code": "03",
"name": "グルメ/お酒",
"ruby": "ぐるめおさけ",
"level": "large"
}
]
},
{
・・・
}
],
"unit": {
"datum": "wgs84",
"coord_unit": "degree"
}
}
レスポンス例(多言語返却時 ※lang=ja.en.ko指定)
{
"count": {
"total": 29,
"offset": 0,
"limit": 10
},
"items": [
{
"code": "02301-1400565",
"name": {
"en": "Pizzeria Spontini Cascade Harajuku",
"ja": "PIZZERIA SPONTINI(ピッツェリア スポンティーニ) カスケード原宿店",
"ko": "PIZZERIA SPONTINI(피체리아 스폰티니) 캐스케이드 하라주쿠점"
},
"ruby": {
"ja": "ぴっつぇりあ すぽんてぃーに かすけーどはらじゅくてん"
},
"phone": "0364345850",
"address_name": {
"en": "Tokyo Shibuya-ku Jingumae 1-10-37CASCADEHARAJUKU2F",
"ja": "東京都渋谷区神宮前1-10-37 CASCADE HARAJUKU2F",
"ko": "Tokyo Shibuya-ku Jingumae 1-10-37CASCADEHARAJUKU2F"
},
"address_code": "13113015000",
"coord": {
"lat": 35.670053,
"lon": 139.703776
},
"distance": 645,
"postal_code": "1500001",
"categories": [
{
"code": "0306004001",
"name": {
"en": "Pizza",
"ja": "ピザ",
"ko": "피자"
},
"ruby": {
"ja": "ぴざ"
},
"level": "detail"
},
{
"code": "0306004",
"name": {
"en": "Pizza",
"ja": "ピザ",
"ko": "피자"
},
"ruby": {
"ja": "ぴざ"
},
"level": "small"
},
{
"code": "0306",
"name": {
"en": "Western Food",
"ja": "洋食系/西洋料理",
"ko": "양식/서양 요리"
},
"ruby": {
"ja": "ようしょくけいせいようりょうり"
},
"level": "middle"
},
{
"code": "03",
"name": {
"en": "Gourmet / Alcohol",
"ja": "グルメ/お酒",
"ko": "맛집/술집"
},
"ruby": {
"ja": "ぐるめおさけ"
},
"level": "large"
}
]
},
{
・・・
}
],
"unit": {
"datum": "wgs84",
"coord_unit": "degree"
}
}