지도와 핀이 화면에 있으면 실제 위치 정보를 보여주는 서비스처럼 보일 수 있다. 나는 도구형 홈페이지의 지도 소스와 설명서를 다시 읽고 화면 기능을 확인하기 위한 예시와 실제 장소 데이터를 구별해 기록하기로 했다. 같은 모양 안에서도 무엇을 믿고 사용할 수 있는지는 다르다.
확인한 지도 영역은 코드로 그린 도로와 화면 배치용 위치값, 예시 장소 목록을 사용한다. 설명서에도 실제 서비스 전에 검증된 데이터 연결이 필요하다고 적혀 있다. 이 글에서는 원래 장소 이름이나 고객 주소를 옮기지 않고 무엇을 구현했고 어떤 연결이 더 필요한지 설명한다.
화면 위치값과 지리 좌표는 다르다
현재 지도 핀의 위치는 화면 안의 가로·세로 비율로 배치되어 있다. 도로도 SVG 경로로 그린다. 이 값은 카드를 어떤 위치에 보여줄지 만드는 데 쓸 수 있지만 실제 위도와 경도, 도로 거리나 도착 시간을 나타내는 값은 아니다. 숫자가 들어 있다고 지리 계산의 근거가 되는 것은 아니다.
실제 지도 연결에서는 좌표 체계와 위치의 정확성, 서비스가 사용하는 지도 데이터를 확인해야 한다. 예시 비율을 실제 좌표처럼 변환해 거리나 길찾기를 만들지 않는다. 화면 배치를 만드는 자료와 사람의 이동 판단에 쓰는 자료의 역할을 먼저 구별하는 기준이다.
필터를 누르는 동작과 정보의 진위도 나눈다
지도 영역의 분류 버튼은 선택한 종류에 따라 핀과 장소 목록을 바꾼다. 이 소스를 확인하면 어떤 상태가 어떤 목록을 고르는지 설명할 수 있다. 그 장소의 영업시간과 시설, 이용 가능 여부가 실제로 맞는지 확인했다는 뜻은 아니다.
확대처럼 보이는 버튼이나 장소 카드에도 실제 연결이 있는지 살펴야 한다. 확인한 영역에서는 일부 버튼에 이동 처리 코드가 없었다. 나는 모양과 선택 상태, 실제 이동을 각각 읽는다. 기능을 소개할 때 앞으로 연결할 버튼과 현재 동작하는 선택을 같은 완료 상태로 표현하지 않는다.
예시라는 설명은 정보를 사용하는 자리에서 읽히게 한다
작업 설명서에 예시라고 적혀 있어도 방문자는 그 문서를 읽지 않는다. 화면의 장소 안내가 실제 정보처럼 보이면 이용자는 현재 사용할 수 있는 자료라고 받아들일 수 있다. 이 기록에서는 구현 범위를 예시로 분명히 설명한다. 실제 운영에 적용한다면 지도와 목록을 사용하는 자리에도 그 상태를 연결해야 한다.
실제 연결이 끝나기 전에는 길찾기나 영업 중 표시를 실제 데이터처럼 약속하지 않는다. 예시 화면은 카드 배치와 필터, 목록과 핀의 관계를 확인하는 용도로 활용할 수 있다. 그런 목적은 유지하면서 실제 이동 판단의 근거와 구별하면 시안의 효용과 정보의 책임을 함께 다룰 수 있다.
실제 정보에는 확인 시점과 갱신 책임이 필요하다
장소가 존재하는지 확인한 것과 오늘 이용 가능한지는 다를 수 있다. 운영 시간, 진입 조건, 제공 시설처럼 바뀌는 항목은 출처와 확인 시점, 갱신할 주체를 함께 정해야 한다. 모든 정보를 하나의 마지막 수정일로만 표시하면 어떤 항목을 언제 확인했는지 알기 어려울 수 있다.
새 데이터 설계에서는 장소 식별자와 좌표, 운영 조건, 확인 상태를 구별해 기록할 수 있다. 아직 확인하지 않은 항목은 미확인으로 남기고 닫힌 장소와 자료를 찾지 못한 장소도 같은 값으로 처리하지 않는다. 이는 새 적용의 설계 기준이며 이번에 원래 장소를 방문하거나 운영 정보를 조사한 결과는 아니다.
제보 버튼에도 실제 저장과 확인 흐름을 둔다
정보를 제보하게 하는 화면이 있다고 제보가 서버에 저장됐다고 말할 수는 없다. 확인한 프로젝트에는 화면 상태를 바꾸는 예시 흐름도 있었다. 입력을 받고 완료 문구를 보여주는 코드와 실제 접수 저장소, 검토 뒤 지도에 반영하는 과정은 구별해야 한다.
실제 제보 기능을 붙인다면 요청 결과와 검토 상태, 공개 반영을 각각 정한다. 제보자가 입력한 문장을 바로 사실로 공개하지 않고 중복과 잘못된 위치, 오래된 정보도 확인할 수 있어야 한다. 이 글을 작성하며 실제 제보를 보내거나 다른 운영 사이트의 저장 기능을 바꾸지는 않았다.
지도 구현의 다음 단계를 정확하게 남긴다
이번 글은 현재 지도 함수와 예시 데이터, 설명서와 과거 화면 검수 범위를 확인해 작성했다. 과거 기록의 필터 동작 확인을 실제 장소 정보 검증으로 넓히지 않았다. 새 브라우저에서 지도 이동이나 기기 위치, 길찾기 동작을 확인한 것도 아니다.
나는 지도처럼 보이는 화면을 만들었다는 사실과 실제 장소 서비스에 필요한 연결을 나누어 남긴다. 홈페이지를 맡기는 사람도 이 차이를 알면 무엇을 요청하고 어떤 자료를 준비할지 구체적으로 판단할 수 있다. 지도 기능의 깊이는 화면의 핀 수보다 정보와 사용 목적이 어떻게 연결되는지에서 드러난다.