Ko:OpenHistoricalMap/JOSM

From OpenStreetMap Wiki
Jump to navigation Jump to search
  • OpenHistoricalMap/JOSM
  • In other languages
주요 문서: Ko:OpenHistoricalMap/Contributing

JOSM[1]은 iD 편집기에서 더욱 발전한 프로그램형 편집기로, 불러오기 기능이나 나라 간의 경계 편집처럼 대규모 작업을 할 때에 유용합니다. 오픈히스토리컬맵은 오픈스트리트맵 기여자분들이 사용하는 것과 동일한 배포판을 사용합니다. JOSM을 사용하여 OHM에 기여하려면 먼저 OSM을 기준으로 한 설정 기본값에서 몇 가지 변경을 해두어야 합니다.

기본 세팅

주요 문서: JOSM/Installation
주요 문서: JOSM/Guide

서버 설정 변경

오픈스트리트맵 대신 오픈히스토리컬맵을 편집하려면 먼저 연결 설정을 변경해야 합니다.

information icon

2025년 1월부로 OAuth 2.0만 지원되는 인증 방식입니다. 기본 인증은 더 이상 지원되지 않습니다.
  1. 환경설정 창을 열고 OSM 서버 탭으로 전환하세요.
  2. '기본 OSM 서버 URL 사용' 옵션의 체크를 해제하세요.
  3. OSM 서버 URL를 https://www.openhistoricalmap.org/api (끝에 슬래시 없음) 으로 설정합니다.[2]
  4. 유효성 검사를 클릭하세요.
  5. Use OAuth 2.0 사용 옵션을 선택하세요.
  6. 액세스 토큰 시크릿에서 지금 승인(완전 자동화)를 클릭하세요.
  7. 아직 OHM에 로그인이 되어 있지 않다면 로그인하라는 표시가 뜹니다.
  8. An Authorization Required page should have opened in your default Web browser, asking you to grant JOSM several permissions. Click Authorize.
  9. If you have not already set up any OAuth2 apps in JOSM, you may be asked to allow remote control to set credentials in JOSM. Click Yes, once.
  10. You should be taken to a page that says simply "OK". Return to JOSM and click OK.

지도 보기

특정 지물이 시간에 따라 변화할 경우, OHM은 기본적으로 여러 개의 해당 지물을 복제한 다음 start_date=* / end_date=* 태그로 구별해 두고 있습니다. 그러나 type=*과 name=*는 동일하게 유지되는 경우가 많으므로, 관계 패널에서 똑같은 이름이 붙여진 수많은 관계가 나열되는 수가 있습니다. 관계들을 더 명확히 표시하기 위해서는 다음과 같이 설정하여야 합니다.

  1. 환경설정 (Preference)에 QuickLabel 플러그인을 설치
  2. 상단 메뉴바의 보기 탭 (View)에서 QuickLabel 창을 열기
  3. 아래의 설정을 변경
    1. '하위' (Sub) 목록의 최상단 줄에 {start_date} -- {end_date} 를 추가. 더 효과적인 기능은 GitHub 페이지의 예시를 참고하세요.
    2. '메인' (Main) 목록 최하단에 임의의 태그 추가 (기본적으로 목록 적용이 안되는 버그 가능성 존재)
    3. '시작 시 적용' (Apply on startup) 활성화
  4. '적용' (Apply) 클릭

 To do: 사이드바에서 객체를 명확히 구분하는 방법은?

오버패

Overpass API를 사용하면 전체 데이터 대신 그 일부만 다운로드하여 대규모 피처 또는 방대한 양의 피처를 처리할 수 있습니다.

  1. 환경설정 창을 열고 OSM 서버 탭으로 전환하세요.
  2. 창 하단에 있는 '전문가 모드'의 체크 표시를 누릅니다.
  3. Overpass server를 https://overpass-api.openhistoricalmap.org/api/로 설정한 다음 확인을 클릭합니다.
  4. [파일] 로 이동하여 [데이터 다운로드]를 선택하고, Overpass API에서 다운로드 탭으로 전환합니다.
Warning
 In many parts of the world, OHM's relation structures are much more complex than OSM's. Make sure your Overpass query includes connected features from different time periods than the one you are focused on. Before splitting any way that may be part of a boundary relation, download its parent ways and relations and download any incomplete relations in full, with their members. Afterwards, run the validator and check for any warnings about modifying incomplete relations or about gaps in relations, and sort the members of any relation you may have modified.

원격 조종

원격 조종 기능을 사용하면 OSM 웹사이트를 탐색하는 동안 JOSM에 빠르게 접속하여 관련 데이터에 접근할 수 있습니다.

  1. JOSM에서 환경설정 창을 열고 원격 조종 탭으로 이동한 뒤, 원격 조종 활성화에 체크 표시를 누릅니다.
  2. openhistoricalmap.org 웹페이지에서 편집 버튼 옆의 드롭다운 메뉴를 클릭하고 원격 제어 계정으로 편집을 선택합니다.

JOSM이 로컬 호스트 포트 8111에서 수신 대기할 수 있도록 운영 체제에 내장 방화벽을 구성해야 할 수 있습니다. 구성 절차는 시스템마다 다릅니다.

utilsplugin2

JOSM 내에서 OHM 웹사이트를 열 수 있는 바로가기를 구성할 수 있습니다. 환경 설정 창의 'Utilsplugin2 설정' 탭에서 사용자 지정 URL을 다음과 같이 추가하세요.

오픈히스토리컬맵에서 특정 요소의 편집 역사 보기
https://www.openhistoricalmap.org/{#type}/{#id}/history
오픈히스토리컬맵에서 특정 요소 검색하기
https://www.openhistoricalmap.org/{#type}/{#id}

아니면 JOSM 환경설정 폴더에 있는 plugins/utilsplugin2/customurl.txt 파일에 다음 줄을 추가하면 됩니다.

View Element History on OpenHistoricalMap [demo, =Ctrl-Shift-H]
https://www.openhistoricalmap.org/{#type}/{#id}/history
Browse Element on OpenHistoricalMap [demo, =Ctrl-Shift-I]
https://www.openhistoricalmap.org/{#type}/{#id}

기본적으로 이러한 사용자 지정 URL은 [데이터 ‣ 사용자 지정 URL 선택] (Data ‣ Select custom URL)메뉴 항목에서만 액세스할 수 있습니다. 하지만 위에서 처럼 이름에 특수 접미사를 추가하면 [보기 ‣ 기록(웹)] / [데이터 ‣ 사용자 지정 URL 열기] (View ‣ History (web) / Data ‣ Open custom URL)항목과 해당 단축키를 통해서도 이러한 URL에 액세스할 수 있도록 만들 수 있습니다.

날짜 필터

ohm-date-filter 플러그인을 사용하면 지도상에서 특정 기간의 데이터만 표시되도록 필터링할 수 있어, 지금 편집하지 않는 시간대의 데이터로 인한 혼란을 줄일 수 있습니다. 이 플러그인을 설치하려면 환경 설정 창의 플러그인 (Plugins)탭으로 이동하여 ohm을 검색한 뒤 ohm-date-filter 옆의 확인란을 체크하세요.

환경설정 파일 교체

JOSM preferences.xml 파일을 교체하고 JOSM을 실행하려고 하는데 서버 환경설정을 처음부터 다시 바꾸길 바라지 않는다면 다음과 같이 실행해 보시기 바랍니다.

Mac과 리눅스

By default JOSM puts its preferences file in a subdirectory, JOSM; the details of where this is stored can be found in this article. You can clone this directory. For example, copy JOSM to JOSM-OHM; edit the preferences.xml file and review & possibly change the settings for osm-server.url and potentially download.overpass.server.

Run JOSM from the command line

Once this is done, you can set up an alias in your shell profile such as: 

josm-ohm='java -Djosm.pref=/Users/<YourName>/Library/Preferences/JOSM-OHM -jar /Users/myhomedir/JavaApps/josm-tested.jar

Linux

You can create a new shortcut with java -Djosm.pref=/Users/<YourName>/Library/Preferences/JOSM-OHM -jar /Users/myhomedir/JavaApps/josm-tested.jar

Mac

  1. Open the "Applications" folder in Finder
    1. Right-click JOSM.app , and "Duplicate" it (also rename it to be about OHM how you like it)
    2. Right-click the new shortcut, and view "Package content"
  2. In the ./Contents/app folder, open the JOSM.cfg file in a text editing software
    1. Add java-options=-Djosm.pref=/Users/<YourName>/Library/Preferences/JOSM-OHM in a new line
    2. Save
  3. Double-click the new app in Finder to run it (and "Keep in dock" it alongside OSM JOSM via "Options" in the right-click menu!)

윈도우

 To do: (윈도우 환경은 준비 중)

알려진 문제

위의 기본 설정 외에는 JOSM 자체에서 OHM과 최적화되지 않은 부분이 몇 가지 존재합니다.

  • type=chronology처럼 OHM 태그에 대한 사전설정이 없습니다. [1]
  • start_date=*과 end_date=*, 또는 그에 딸린 EDTF 하위키에 대한 유효성 검사 규칙이 없습니다. (날짜가 유효한지 확인 불가능)
  • 유효성 검사 규칙에서 *:source=*가 아니라 source:*=*를 쓰도록 권장하는 문제가 있습니다.
  • 유효성 검사 규칙에서 여러 도로가 중첩될 때 시간대가 다르더라도 감지하는 문제가 있습니다.

각주

  1. ↑ 정식 명칭은 'Java OpenStreetMap Editor'로 그것의 약자이지만 'Java OpenHistoricalMap Editor'라 생각하셔도 상관은 없습니다.
  2. ↑ https://api.openhistoricalmap.org/api is also supported for consistency with the default OSM connection settings. [2]
Retrieved from "https://wiki.openstreetmap.org/w/index.php?title=Ko:OpenHistoricalMap/JOSM&oldid=2936322"