API 명세 | Notion

🚽 화장실 조회 API

GET /api/toilets

🔍 설명

사용자의 위도/경도를 기반으로 반경 내 공중화장실 목록을 조회합니다. 기본 반경은 500m이며, 반경을 키우거나 줄일 수 있습니다.

📥 요청 (Request)

파라미터	타입	필수	기본값	설명
`lat`	double	✅	없음	사용자 현재 위치의 위도
`lng`	double	✅	없음	사용자 현재 위치의 경도
`radius`	double	❌	`500`	검색 반경 (단위: 미터)

예시 요청:

GET /api/toilets?lat=37.5665&lng=126.9780&radius=500

📤 응답 (Response)

json
[
  {
    "id": "e8e2fc7a-b7d0-4df2-9e1f-7d748e0c114f",
    "toiletName": "서울시청 공중화장실",
    "roadAddress": "서울특별시 중구 세종대로 110",
    "lotNumberAddress": "서울특별시 중구 태평로1가 31",
    
    "maleToiletCount" : 3
    "maleUrinalCount" : 2
    "maleDisabledToiletCount" : 1
    "maleDisabledUrinalCount" : 1
    "maleChildToiletCount" : 1
    "maleChildUrinalCount" : 1

    "femaleToiletCount" : 1
    "femaleDisabledToiletCount" : 1
    "femaleChildToiletCount" : 1

    "openTime" : "24시간"
    "latitude" : 37.5662952,
    "longitude" : 126.9779451,
    "toiletType" : "수세식"

    
    
  },
  ...
]

필드 설명 (응답 중 일부)

필드명	타입	설명
`id`	Long	고유 식별자
`toiletName`	String	화장실 이름
`roadAddress`	String	도로명 주소
`lotNumberAddress`	String	지번 주소
`maleToiletCount`	Integer	남성용 대변기 수
`maleUrinalCount`	Integer	남성용 소변기 수
`maleDisabledToiletCount`	Integer	남성용 장애인 대변기 수
`maleDisabledUrinalCount`	Integer	남성용 장애인 소변기 수
`maleChildToiletCount`	Integer	남성용 어린이 대변기 수
`maleChildUrinalCount`	Integer	남성용 어린이 소변기 수
`femaleToiletCount`	Integer	여성용 대변기 수
`femaleDisabledToiletCount`	Integer	여성용 장애인 대변기 수
`femaleChildToiletCount`	Integer	여성용 어린이 대변기 수
`openTime`	String	개방시간
`latitude`	Double	위도
`longitude`	Double	경도
`toiletType`	String	수세식인지

⚠️ 유의사항

반경 안의 모든 화장실을 거리순으로 정렬하여 반환합니다.
위도·경도는 소수점 6자리까지 정밀합니다.
최대 100개까지 응답할 수 있도록 서버에 제한이 있을 수 있습니다.