미디어위키 API 도움말
이 페이지는 자동으로 생성된 미디어위키 Action API 설명문서입니다.
list=geosearch (gs)
- 이 모듈은 read 권한을 요구합니다.
- 이 모듈은 생성기로 사용할 수 있습니다.
- 출처: GeoData
- 라이선스: WTFPL
특정 지역에 위치한 좌표가 있는 문서를 반환합니다.
특정 매개변수:
다른 일반 매개변수를 사용할 수 있습니다.
- gscoord
검색할 주위의 좌표입니다.
형식: 위도와 경도를 파이프(|)로 구분합니다.
- gspage
검색할 문서 제목입니다.
- gsbbox
검색할 경계 상자: 왼쪽 상단 및 오른쪽 하단 모서리의 좌표는 파이프(|)로 구분합니다.
- gsradius
미터 단위로 반경을 검색합니다.
- 유형: 정수
- 값은 10와 10,000 사이여야 합니다.
- 기본값: 500
- gsmaxdim
거리가 이 값 이하인 객체로 검색을 제한합니다. 단위: 미터
- 유형: 정수
- gssort
반환된 결과의 정렬 순서를 설정합니다.
- distance
- 중심에서 부터의 거리에 따라 문서 순위를 매깁니다.
- relevance
- CirrusSearch를 사용하여 Special:Search와 유사하게 관련성 순으로 문서 순위를 매깁니다. 현재는 일래스틱서치 백엔드를 사용하는 위키에서만 지원됩니다. mw:Extension:GeoData#Search backends를 참조하세요.
- 다음 값 중 하나: distance, relevance 또는 다른 문자열: distance, relevance
- 기본값: distance
- gslimit
반환할 문서의 최대 개수입니다.
- 유형: 정수 또는 max
- 값은 1와 500 사이여야 합니다.
- 기본값: 10
- gsglobe
검색할 지구본입니다. 자세한 내용은 mw:Special:MyLanguage/Extension:GeoData#Glossary를 참조하세요.
- 다음 값 중 하나: earth, mars, moon, venus 또는 다른 문자열: earth, mars, moon, venus
- 기본값: earth
- gsnamespace
검색할 이름공간입니다.
- 값 (|로 구분): 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 또는 다른 문자열: 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15
- 모든 값을 지정하려면, *를 사용하십시오.
- 기본값: 0
- gsprop
반환할 추가 좌표 속성 값입니다. (항상 반환되는 속성: lat, lon, 그리고 불린 플래그 형태의 primary와 secondary 중 하나.)
- type
- 좌표가 가리키는 대상의 유형입니다. 자세한 사항은 mw:Special:MyLanguage/Extension:GeoData#Usage를 참조하십시오.
- name
- 객체의 이름입니다.
- dim
- 객체의 대략적인 크기. (단위: 미터)
- country
- ISO 3166-1 alpha-2 국가 코드 (예: US 또는 RU).
- region
- ISO 3166-2 지역 코드 (대시 다음의 ISO 3166-2 코드 부분. 예: FL 또는 MOS).
- globe
- 좌표와 관계 있는 천체 (예시: moon 또는 pluto). 기본값은 지구입니다. 자세한 사항은 mw:Special:MyLanguage/Extension:GeoData#Glossary를 참조하세요.
- 값 (|로 구분): country, dim, globe, name, region, type 또는 다른 문자열: country, dim, globe, name, region, type
- 기본값: globe
- gsprimary
반환할 좌표의 종류입니다.
- primary
- 문서 주제의 위치입니다. 제목 당 최대 하나의 기본 좌표에 위치합니다.
- secondary
- 본문에서 언급한 일부 객체의 위치입니다. 여러 보조 좌표를 제목과 연결할 수 있습니다.
- all
- 1차 좌표와 2차 좌표를 둘 다 반환합니다.
- 다음 값 중 하나: all, primary, secondary 또는 다른 문자열: all, primary, secondary
- 기본값: primary
예시:
- 37° 47′ 13.1″ N, 122° 23′ 58.84″ W 좌표점 주변을 검색합니다
- api.php?action=query&list=geosearch&gsradius=10000&gscoord=37.786971|-122.399677 [연습장에서 열기]
- 경계 상자 내에서 검색
- api.php?action=query&list=geosearch&gsbbox=37.8|-122.3|37.7|-122.4 [연습장에서 열기]