スポットカテゴリ検索

/spot/category_code [GET]

基本情報

概要

カテゴリを条件として、スポット一覧を取得します。 スポットとは下記のような施設全般を指します。

• 飲食店、医療機関、娯楽施設、宿泊施設、小売店、公共施設、観光地 など

禁止事項

本APIで取得した駐車場データについて、データ提供元により許諾されていないため、
駐車場料金の安い順で表示することはお控えください。

URL

https://{HOST}/{CID}/v1/spot/category_code

※RapidAPIでは提供しておりません

出力形式

• JSON

対応言語

• ja, en, ko, zh-CN, zh-TW, th

出力順

• 検索のランキングを考慮した株式会社ナビタイムジャパン独自のスコア降順
  
• 緯度経度を指定した場合は指定緯度経度からの距離昇順

スコアについて

スコアは順番が常に最適になるよう変動していますので、ご要望などによる順番変更はできません

パラメータ

パラメータ名	必須	概要	型名	デフォルト値	上下限/選択値	備考
category	✔	カテゴリコード	文字列			検索したいカテゴリコード 複数指定の場合は「.」区切りで指定
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指定時のみ使用可能
opening_time		営業時間	文字列（日付時刻） YYYY-MM-DDThh:mm:ss	現在時刻		「対象スポットが指定した日時に営業しているかどうか」がレスポンスに付与されます 「options=opening_hours」指定時かつ営業時間に関するデータが存在する場合のみ出力します opening_time未指定時は現在時刻を指定します
additional_filter		付加条件	文字列		cvs_for_large_car：乗用車以外も駐車可能なコンビニ	スポットに関する特定の条件を指定します 詳細はこちらをご覧ください
limit		データの出力件数	数値	10	最小値：1 最大値：100	スポットデータの出力数
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：ミリ秒表記

additional_filterについて

● 乗用車以外も駐車可能なコンビニ
本データは、ナビタイムジャパン独自整備のデータです。
普通車・軽自動車以外の駐車スペースがあるコンビニエンスストアを検索可能です（二輪車は含みません）。

langパラメータの指定時の注意点

・多言語に対応したレスポンスはMultilingualオブジェクトとして出力されることにご注意ください。
・一部スポットは多言語データが存在しないため、多言語指定時には返却されない場合があります。

パラメータ構成例

• 中目黒周辺のガソリンスタンドを10件検索

/spot/category_code?coord=35.644377,139.699012&category=0801

レスポンス

名称	レスポンス名	型名	配列	説明
検索数	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」の値に紐づいているスポットのみ出力されます cvs_for_large_car：乗用車以外も駐車可能なコンビニ

Coordinateオブジェクト

名称	レスポンス名	型名	配列	説明
スポットの緯度	lat	数値
スポットの経度	lon	数値

Multilingualオブジェクト

名称	レスポンス名	型名	配列	説明
英語名称	en	文字列
日本語名称	ja	文字列
韓国語名称	ko	文字列
タイ語名称	th	文字列
中国語(簡体字)名称	zh-CN	文字列
中国語(繁体字)名称	zh-TW	文字列

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": 6,
        "offset": 0,
        "limit": 10
    },
    "items": [
        {
            "code": "02022-1308515",
            "name": "富士エネルギー株式会社 目黒営業所",
            "ruby": "ふじえねるぎーかぶしきがいしゃめぐろえいぎょうしょ",
            "phone": "0334926676",
            "address_name": "東京都目黒区目黒1-24-2",
            "address_code": "13110024000",
            "coord": {
                "lat": 35.635713,
                "lon": 139.709644
            },
            "distance": 903,
            "postal_code": "1530063",
            "categories": [
                {
                    "code": "0801001012",
                    "name": "その他ガソリンスタンド",
                    "ruby": "そのたがそりんすたんど",
                    "level": "detail"
                },
                {
                    "code": "0801001",
                    "name": "ガソリンスタンド",
                    "ruby": "がそりんすたんど",
                    "level": "small"
                },
                {
                    "code": "0801",
                    "name": "ガソリンスタンド",
                    "ruby": "がそりんすたんど",
                    "level": "middle"
                },
                {
                    "code": "08",
                    "name": "交通",
                    "ruby": "こうつう",
                    "level": "large"
                }
            ]
        },
        {
            ・・・
        }
    ],
    "unit": {
        "datum": "wgs84",
        "coord_unit": "degree"
    }
}

レスポンス例(多言語返却時 ※lang=ja.en.ko指定)

{
    "count": {
        "total": 6,
        "offset": 0,
        "limit": 10
    },
    "items": [
        {
            "code": "02022-1308515",
            "name": {
                "en": "Fuji Energy Meguro Sales Office",
                "ja": "富士エネルギー株式会社 目黒営業所",
                "ko": "후지 에너지 메구로 영업소"
            },
            "ruby": {
                "ja": "ふじえねるぎーかぶしきがいしゃめぐろえいぎょうしょ"
            },
            "phone": "0334926676",
            "address_name": {
                "en": "Tokyo Meguro-ku Meguro 1-24-2",
                "ja": "東京都目黒区目黒1-24-2",
                "ko": "도쿄도 메구로구 메구로 1-24-2"
            },
            "address_code": "13110024000",
            "coord": {
                "lat": 35.635718,
                "lon": 139.709636
            },
            "distance": 1360,
            "postal_code": "1530063",
            "categories": [
                {
                    "code": "0801001012",
                    "name": {
                        "en": "Other Gas Station",
                        "ja": "その他ガソリンスタンド",
                        "ko": "기타 주유소"
                    },
                    "ruby": {
                        "ja": "そのたがそりんすたんど"
                    },
                    "level": "detail"
                },
                {
                    "code": "0801001",
                    "name": {
                        "en": "Gas Station",
                        "ja": "ガソリンスタンド",
                        "ko": "주유소"
                    },
                    "ruby": {
                        "ja": "がそりんすたんど"
                    },
                    "level": "small"
                },
                {
                    "code": "0801",
                    "name": {
                        "en": "Gas Station",
                        "ja": "ガソリンスタンド",
                        "ko": "주유소"
                    },
                    "ruby": {
                        "ja": "がそりんすたんど"
                    },
                    "level": "middle"
                },
                {
                    "code": "08",
                    "name": {
                        "en": "Transportation",
                        "ja": "交通",
                        "ko": "교통"
                    },
                    "ruby": {
                        "ja": "こうつう"
                    },
                    "level": "large"
                }
            ]
        },
        {
            ・・・
        }
    ],
    "unit": {
        "datum": "wgs84",
        "coord_unit": "degree"
    }
}