一度定義した分類
フリーダイビング・スクーバダイビング・シュノーケリング・海洋生物・ライブアボードの分類を、ウェブとAPIで共有します。
公開API・バージョン 17
場所検索、地図、詳細ページ、今後のiOS・Androidアプリで同じ分類・料金・シーズン・海洋生物データを使用できるよう、読み取り専用APIを公開します。
フリーダイビング・スクーバダイビング・シュノーケリング・海洋生物・ライブアボードの分類を、ウェブとAPIで共有します。
ページ分割、安定したID、canonicalの詳細パス、APIバージョンヘッダーで、アプリのキャッシュとディープリンクを連携できます。
complete・verified・directoryの区分と出典を一緒に返し、未検証データを整備済み情報として扱わないようにします。
エンドポイント
/api/v1/places国、アクティビティ、海洋生物、観察方法、月、公開料金、場所の種類、プロフィール検証区分を組み合わせます。
/api/v1/places/{country}/{region}/{slug}代表プログラム、料金、シーズン、連絡先、海洋生物プログラム、出典、プロフィールの充実度を返します。
/api/v1/map文字列プールとタプルで圧縮した座標・フィルター・カードデータです。フィールドのインデックスはOpenAPIドキュメントに従います。
/api/v1/map/search商品・料金・連絡先・多言語キーワードは、ユーザーが検索したときだけ遅延読み込みします。
/api/v1/map/full完全なJSONオブジェクトを返す非推奨のパスです。新規連携には基本データと検索用のパスを推奨します。
/api/v1/spots選択した月が公開シーズンに含まれ、該当する海洋生物プログラムを実施しているマーカーのみ、座標とともに返します。
/api/v1/tours出典を確認したホストの日程から、指定期間に重なるものを日付・地域・活動で絞り込み、確定人数に基づくリアルタイムの残席も提供します。
/api/v1/coverageISO 3166-1の249単位について、登録・情報補強・安全上の保留・除外の状態を公開します。
クエリの例
/api/v1/places?iso=BE&kind=operator&limit=5日本の2月のザトウクジラプログラム/api/v1/places?iso=JP&animal=%ED%98%B9%EB%93%B1%EA%B3%A0%EB%9E%98&month=2&limit=20公開料金のあるスクーバダイビング/api/v1/places?activity=scuba-diving&published_price=true&limit=20公式出典で確認されたプロフィール/api/v1/places?profile_tier=verified&limit=203月のジンベエザメスポット/api/v1/spots?month=3&marine_life=%EA%B3%A0%EB%9E%98%EC%83%81%EC%96%B4&limit=209月に済州で募集中のツアー/api/v1/tours?start_date=2026-09-01&end_date=2026-09-30®ion=%EC%A0%9C%EC%A3%BC&open_only=1ライブアボード/api/v1/places?liveaboard=true&limit=20公開料金・シーズン・営業時間・野生生物の出現は変わる場合があります。アプリや外部サービスは、出典URL、確認日、プロフィールの充実度を一緒に表示し、予約前に事業者の公式原文を再確認する必要があります。このAPIはGoogleレビューの原文や評価点を複製しません。