MediaWiki API 帮助
这是自动生成的MediaWiki API文档页面。
文档和例子:https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page
list=geosearch (gs)
- 此模块需要读取权限。
- 此模块可作为发生器使用。
- 来源:GeoData
- 许可协议:WTFPL
返回包含位于某一地区坐标的页面。
具体参数:
其他通用参数可用。
- gscoord
协调要搜索位置的周围。
格式:纬度和精度,用竖线(|)隔开。
- gspage
围绕要搜索页面的页面标题。
- gsbbox
要搜索的边界框:以竖线(|)分隔的左上角和右下角的坐标。
- gsradius
搜索半径(米)。
- 类型:整数
- 值必须介于10和10,000之间。
- 默认:500
- gsmaxdim
限制搜索到不大于此值的对象,单位为米。
- 类型:整数
- gssort
设置返回结果的排序。
- distance
- 按页面到中心的距离对页面进行排名。
- relevance
- 根据 CirrusSearch 对页面的相关性进行排名,类似于 Special:Search 的做法。目前仅在使用 ElasticSearch 后端的 wiki 上受支持,请参阅 mw:Extension:GeoData#Search backends。
- 以下值中的一个:distance、relevance
- 默认:distance
- gslimit
最大返回页面数。
- 类型:整数或max
- 值必须介于1和500之间。
- 默认:10
- gsglobe
要搜索的星球。参见mw:Special:MyLanguage/Extension:GeoData#Glossary获取详情。
- 以下值中的一个:earth
- 默认:earth
- gsnamespace
搜索的命名空间。
- 值(以|或其转义序列分隔):0、1、2、3、4、5、6、7、8、9、10、11、12、13、14、15、100、101、102、103、118、119、126、127、710、711、828、829、1728、1729、2600
- 要指定所有值,请使用*。
- 默认:0
- gsprop
要返回的额外坐标属性。(总是返回以下值的属性:lat、lon,以及primary或secondary之一作为布尔值标记。)
- type
- 坐标指向的目标类型。参见mw:Special:MyLanguage/Extension:GeoData#Usage获取详情。
- name
- 目标名称。
- dim
- 目标近似大小(米)。
- country
- ISO 3166-1 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
- 默认:globe
- gsprimary
要返回的坐标类型。
- primary
- 条目对象的位置。每个标题最多有一个主要的坐标。
- secondary
- 条目中提及的一些对象的位置。任何数量的二级坐标都可以与某个标题相关联。
- all
- 返回主要坐标和二级坐标。
- 以下值中的一个:all、primary、secondary
- 默认:primary
- gsdebug
是否应该返回调试信息。
- 类型:布尔型 (详情)
例子:
- 搜索坐标点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 [在沙盒中打开]