한 번 정의한 분류
프리다이빙·스쿠버다이빙·스노클링·해양동물·리브어보드 분류를 웹과 API가 함께 사용합니다.
PUBLIC API · VERSION 16
웹과 모바일이 공유하는
WaterMap 데이터 계약
장소 검색, 지도, 상세 페이지와 향후 iOS·Android 앱이 같은 분류·가격·시즌·해양동물 데이터를 사용하도록 읽기 전용 API를 공개합니다.
모바일 준비
페이지네이션, 안정적인 ID, canonical 상세 경로와 API 버전 헤더로 앱 캐시와 딥링크를 연결할 수 있습니다.
검증 수준 포함
complete·verified·directory 등급과 출처를 함께 반환해 미검증 데이터를 완료된 정보처럼 다루지 않습니다.
ENDPOINTS
공개 읽기 API
/api/v1/places검색·필터·페이지네이션
국가, 액티비티, 해양동물, 만남 방식, 월, 공개 가격, 장소 종류와 프로필 검증 등급을 조합합니다.
/api/v1/places/{country}/{region}/{slug}업체·장소 상세
대표 상품, 가격, 시즌, 연락처, 해양동물 프로그램, 출처와 프로필 품질을 반환합니다.
/api/v1/map모바일 지도 core wire 데이터
문자열 풀과 tuple로 압축한 좌표·필터·카드 데이터입니다. 필드 인덱스는 OpenAPI 문서를 따릅니다.
/api/v1/map/search필요할 때만 불러오는 검색 색인
상품·가격·연락처·다국어 키워드를 사용자가 검색할 때만 지연 로드합니다.
/api/v1/map/full이전 클라이언트 호환 경로
전체 JSON 객체를 반환하는 deprecated 경로입니다. 신규 연동은 core+search 경로를 권장합니다.
/api/v1/coverage전 세계 조사 현황
ISO 3166-1 249개 단위의 등록·보강·안전 보류·제외 상태를 공개합니다.
QUERY EXAMPLES
바로 확인하기
벨기에 운영사 5곳
/api/v1/places?iso=BE&kind=operator&limit=5일본 2월 혹등고래 프로그램/api/v1/places?iso=JP&animal=혹등고래&month=2&limit=20공개가격이 있는 스쿠버다이빙/api/v1/places?activity=scuba-diving&published_price=true&limit=20공식 출처 검증 프로필/api/v1/places?profile_tier=verified&limit=20리브어보드/api/v1/places?liveaboard=true&limit=20데이터 사용 전에 확인하세요
공개 가격·시즌·운영시간과 야생동물 출현은 변경될 수 있습니다. 앱과 외부 서비스는 출처 URL, 확인일, 프로필 품질을 함께 표시하고 예약 전 운영사 공식 원문을 다시 확인해야 합니다. Google 리뷰 원문이나 평점은 이 API가 복제하지 않습니다.