本文へ移動

公開API・バージョン 17

ウェブとモバイルが共有する
Maptlantisのデータ仕様

場所検索、地図、詳細ページ、今後のiOS・Androidアプリで同じ分類・料金・シーズン・海洋生物データを使用できるよう、読み取り専用APIを公開します。

一度定義した分類

フリーダイビング・スクーバダイビング・シュノーケリング・海洋生物・ライブアボードの分類を、ウェブとAPIで共有します。

モバイル連携に対応

ページ分割、安定したID、canonicalの詳細パス、APIバージョンヘッダーで、アプリのキャッシュとディープリンクを連携できます。

検証区分を含む

complete・verified・directoryの区分と出典を一緒に返し、未検証データを整備済み情報として扱わないようにします。

エンドポイント

公開読み取りAPI

GET
/api/v1/places

検索・フィルター・ページ分割

国、アクティビティ、海洋生物、観察方法、月、公開料金、場所の種類、プロフィール検証区分を組み合わせます。

GET
/api/v1/places/{country}/{region}/{slug}

事業者・場所の詳細

代表プログラム、料金、シーズン、連絡先、海洋生物プログラム、出典、プロフィールの充実度を返します。

GET
/api/v1/map

モバイル地図の基本データの転送形式

文字列プールとタプルで圧縮した座標・フィルター・カードデータです。フィールドのインデックスはOpenAPIドキュメントに従います。

GET
/api/v1/map/search

必要なときだけ読み込む検索インデックス

商品・料金・連絡先・多言語キーワードは、ユーザーが検索したときだけ遅延読み込みします。

GET
/api/v1/map/full

旧クライアント互換パス

完全なJSONオブジェクトを返す非推奨のパスです。新規連携には基本データと検索用のパスを推奨します。

GET
/api/v1/spots

月・海洋生物のシーズン別スポット

選択した月が公開シーズンに含まれ、該当する海洋生物プログラムを実施しているマーカーのみ、座標とともに返します。

GET
/api/v1/tours

公開ツアー日程と残席

出典を確認したホストの日程から、指定期間に重なるものを日付・地域・活動で絞り込み、確定人数に基づくリアルタイムの残席も提供します。

GET
/api/v1/coverage

世界各地の調査状況

ISO 3166-1の249単位について、登録・情報補強・安全上の保留・除外の状態を公開します。

クエリの例

今すぐ確認

データの利用前にご確認ください

公開料金・シーズン・営業時間・野生生物の出現は変わる場合があります。アプリや外部サービスは、出典URL、確認日、プロフィールの充実度を一緒に表示し、予約前に事業者の公式原文を再確認する必要があります。このAPIはGoogleレビューの原文や評価点を複製しません。