Skip to main content최종 업데이트: 2014년 10월 22일.
Posting With Location은 X API의 지오태깅 기능입니다. 이 기능은 게시물에 위치 맥락을 더해 사용자에게 더 의미 있는 경험을 제공하는 데 도움이 됩니다. 예를 들어 “Fireworks!”는 위치와 함께할 때 훨씬 더 관련성이 높아집니다. 샌프란시스코, 캘리포니아의 SoMa 동네에서 올린 “Fireworks!”처럼요. 이 기능을 바탕으로 훌륭한 경험을 만들기 위해 개발자 생태계와 협력하길 기대합니다!
안전하고 원활한 사용 경험을 보장하려면, 개발자는 사용자의 위치 정보를 처리할 때 프라이버시를 세심하게 고려하고 “위치와 함께 게시하기” 경험에서 기본적인 일관성을 제공해야 합니다. 다음은 사용자 프라이버시를 보호하고 사용자가 자신의 행동이 미치는 영향을 이해하도록 돕는 핵심 유의사항입니다:
- 사용자는 ‘위치 포함 게시’ 기능을 사용하려면 명시적으로 옵트인해야 합니다(위치 “켬”).
- 사용자는 자신의 정확한 위치가 게시물과 함께 표시되는 것에 대해 명시적으로 허용해야 합니다. 클라이언트의 위치 기능이 “고정형(sticky)” — 즉, 한 번 위치를 켜면 게시물에 항상 따라붙는 — 인 경우, 장소 이름(place_ids)만 표시하도록 하고, 게시물별 또는 별도의 대체 설정에서 사용자가 정확한 위도와 경도 표시 여부에 추가로 옵트인할 수 있도록 고려하세요.
- 사용자의 위치 데이터를 사용해 게시물을 게시할 때, 그 정보는 사용자의 명시적 허가 없이 게시물과 분리하여 저장되어서는 안 됩니다.
- 사용자의 게시물과 함께 어떤 수준의 위치 정보(있는 경우)가 표시되는지 명확해야 합니다. 이를 달성하는 한 가지 방법은 게시 전에 해당 정보가 어떻게 표시되는지 보여주는 지도를 표시하는 것입니다. 클라이언트에서 사용자가 게시하는 정보에 정확한 위도와 경도가 포함되거나(혹은 그 정보만 게시되는) 경우, 정확한 좌표가 게시된다는 점이 사용자에게 명확해야 합니다.
- 사용자는 게시물을 작성할 때마다 위치를 켜거나 끌 수 있어야 합니다.
- X의 Developer Policy 약관을 준수해야 합니다. 여기에는 게시물의 일부인 경우를 제외하고 X API로부터의 위치 데이터 및 기타 지리 정보를 집계, 캐시 또는 저장할 수 없으며, 해당 위치 데이터 또는 지리 정보를 단독으로 사용할 수 없다는 요구 사항이 포함됩니다.
예시 1: 명시적인 위도와 경도 추가 없음(현재 X 웹 클라이언트 UI)
- 사용자가 게시물을 작성할 때 “위치 추가” 링크를 표시합니다.
- 백그라운드에서 X reverse_geocode API 호출을 사용해 위도, 경도, 위치 측정의 정확도, 사용자가 선호하는 세분화 수준(기본값은 “neighborhood”)을 전달합니다.
- 기본 장소의 이름을 표시합니다(X는 합리적인 방식으로 정렬을 시도합니다. 이 정렬 방식은 X 클라이언트가 수정 없이 목록을 그대로 표시할 수 있도록 설계되어 있습니다).
- 사용자에게 목록에서 다른 위치를 선택할 수 있도록 허용합니다(예: “SoMa, San Francisco”에서 “South Beach, San Francisco”로 변경).
- 중요: 정확한 위치 정보를 표시할 예정이라면 사용자에게 투명하게 알리십시오. 정확한 위치 정보가 표시되는지 사용자가 알 수 있도록 하십시오.
- 모든 게시물 작성 시 위치를 켜거나 끌 수 있는 선택권을 사용자에게 제공하십시오.
예시 2: 기존 지오태깅 구현
여러 X 클라이언트 앱에는 원래의 지오태깅 기능(위도/경도만 전송하고 place_ID를 제공하지 않음)이 구현되어 있습니다. API의 기본 동작은 이를 그대로 따릅니다. 즉, 개발자인 여러분은 기존 앱의 현재 동작을 유지하기 위해 아무런 변경도 할 필요가 없습니다. 실제로 단순히 X에 위도/경도 좌표를 전달하면 X는 해당 위도와 경도를 자동으로 역지오코딩하고, 데이터가 있는 지역의 경우 위도/경도와 함께 place_ID를 표시합니다.
사용자의 정확한 좌표가 X에서 사용되고 표시된다는 점을 사용자에게 투명하게 알리십시오. 기존 앱의 모범 사례는 사용자에게 게시물마다 위치를 켜거나 끌 수 있도록 하는 것입니다. 또한 기본 “고정” 설정으로 정확한 좌표 대신 place_ID만 공유하도록 사용자가 선택할 수 있게 할 수도 있습니다.
X는 클라이언트가 전달한 데이터를 다음과 같이 저장합니다:
- 사용자가 팔로워에게 공개하기로 선택한 모든 데이터를 X가 저장합니다. 이는 X가 게시물 작성 시점을 나타내는 타임스탬프를 저장하는 방식과 유사합니다. 즉, 사용자가 정확한 좌표와 함께 게시물을 올린 경우, 해당 게시물이 존재하는 동안 X는 게시물과 함께 이 정확한 위치를 저장합니다. 사용자는 설정 페이지의 “내 위치 기록 지우기” 버튼을 클릭하여 게시물의 위치 데이터를 지울 수 있으며, 방법은 여기에서 확인할 수 있습니다.
게시물에 위치 정보를 추가하면 사용자 관점에서 맥락과 가치가 크게 향상됩니다. 다만 클라이언트에서 위치 기능을 구현할 때는 위치 중심 제품을 설계하는 과정에서 개인정보 보호와 사용자에 대한 투명성을 핵심 고려 사항으로 삼아 신중히 접근해야 합니다.
개인정보 보호, 위치, 기타 지오 기능과 관련해 질문이나 의견이 있으시면 문의해 주세요. 
