Sign in
My place

내 장소 저장

출발지 통합 검색에서 사용자가 선택한 결과를 내 장소로 저장합니다.

요청 구성 방법

  1. POST /api/departure-places/searches로 장소를 검색합니다.
  2. 응답의 results에서 사용자가 하나를 선택합니다.
  3. 선택 결과의 필드를 그대로 복사하고 사용자가 입력한 alias를 추가합니다.

type은 원본 검색 결과가 지하철역(STATION), 주소(ADDRESS), 일반 장소(PLACE) 중 무엇인지 보존합니다. 저장·수정·삭제 권한에는 영향을 주지 않습니다.

동일한 위치, 주소, 표시명 또는 별칭의 중복 저장을 허용하며 현재 저장 개수 제한은 없습니다. 저장된 위치 스냅샷은 변경하지 않고, 이후 수정 API에서는 별칭만 변경할 수 있습니다.

장소 용도

  • category에는 HOME, WORK, OTHER 중 하나를 보낼 수 있습니다.
  • category를 생략하면 서버가 OTHER로 저장합니다.
post/api/me/places

Request

  • Base URL: https://3-35-119-70.sslip.io
  • URL: https://3-35-119-70.sslip.io/api/me/places
  • Auth: HTTP bearer

Request body

aliasstring required

회원이 지정한 장소 별칭

category'HOME' | 'WORK' | 'OTHER' nullable

회원이 지정한 장소 용도입니다. 프론트엔드는 이 값으로 아이콘을 표시합니다. 생략하면 서버가 OTHER로 저장합니다.

type'STATION' | 'ADDRESS' | 'PLACE' required

출발지 검색 응답의 결과 유형을 그대로 전달합니다.

  • STATION: 지하철역 검색 결과
  • ADDRESS: 도로명주소 또는 지번주소 검색 결과
  • PLACE: 상호·시설 등 일반 장소 검색 결과

저장 장소의 원본 분류를 보존하는 값이며, 별칭 수정이나 삭제 권한에는 영향을 주지 않습니다.

displayNamestring required

출발지 검색 응답의 displayName을 그대로 전달합니다. 카카오 검색 결과에서 화면에 표시한 원본 장소명입니다.

addressstring required

출발지 검색 응답의 address를 그대로 전달합니다. 도로명주소가 있으면 도로명주소가 대표 주소로 제공됩니다.

roadAddressstring nullable

출발지 검색 응답의 roadAddress를 그대로 전달합니다. 검색 결과에 도로명주소가 없으면 생략하거나 null로 전달합니다.

jibunAddressstring nullable

출발지 검색 응답의 jibunAddress를 그대로 전달합니다. 검색 결과에 지번주소가 없으면 생략하거나 null로 전달합니다.

latitudenumber required

출발지 검색 응답의 WGS84 latitude를 그대로 전달합니다. -90 이상 90 이하이며 소수점 이하는 최대 15자리입니다.

longitudenumber required

출발지 검색 응답의 WGS84 longitude를 그대로 전달합니다. -180 이상 180 이하이며 소수점 이하는 최대 15자리입니다.

Example request

{
  "alias": "회사",
  "category": "WORK",
  "type": "PLACE",
  "displayName": "강남파이낸스센터",
  "address": "서울 강남구 테헤란로 152",
  "latitude": 37.500028,
  "longitude": 127.036502
}

Response

내 장소 저장 성공

Changes

No recorded changes to this operation across all 1 revision of this API.