Jump to content

Справка:Данные для географических карт

From mediawiki.org
This page is a translated version of the page Help:Map Data and the translation is 21% complete.
PD Примечание: Редактируя эту страницу, вы соглашаетесь на передачу своего вклада по лицензии CC0.
Подробнее — в проекте Помощь с общественным достоянием.
PD

Данные для географических карт (англ..Map data) предусматривает возможность для пользователей хранить в проектах Вики данные GeoJSON аналогично хранению там изображений . Другие проекты Вики могут использовать эти данные для отображения их на картах наряду с другими индивидуальными настройками географических карт.

To create a new map data, go to Wikimedia Commons, and create a new page in the Data namespace with the .map suffix, such as Data:Sandbox/Name/Example.map. Feel free to experiment by creating pages with the Sandbox/<username>/ prefix.

На данный момент контент можно редактировать только в формате исходных данных JSON Eventually, we hope there will be a powerful editor to simplify GeoJSON creation (you can enable the KartoEditor gadget to edit them directly or use the geoJSON website and then copy the GeoJSON data).

Лицензирование данных

All data in the Data: namespace must licensed under one of the following licences:

  • CC0-1.0
  • CC-BY versions: CC-BY-1.0, CC-BY-2.0, CC-BY-2.5, CC-BY-3.0, CC-BY-4.0, CC-BY-4.0+
  • CC-BY-SA versions: CC-BY-SA-1.0, CC-BY-SA-2.0, CC-BY-SA-2.5, CC-BY-SA-3.0, CC-BY-SA-4.0, CC-BY-SA-4.0+
  • ODbL-1.0

The default license is empty string (e.g invalid license) and when a user tries to save page with invalid license, they will be notified of the allowed licenses.

Top-level fields

Map data has several required and optional top-level elements:

Имя Required? Описание
license Обязательно Always be set to one of the allowed string values, e.g. "CC0-1.0". (See #Data licensing.)
description По желанию Set to a localized string value - an object with at least one key-value, where the key is a language code (e.g. "en"), and the value is a description string.
sources По желанию A Wiki markup string value that describes the source of the map data.
zoom По желанию An integer between 0 and 18. This value is only used for displaying map on its own page, not when including it in the articles.
latitude
longitude
По желанию The center of the map when displaying it on its own page, not when including it in the articles.
data Обязательно The valid GeoJSON content. Per GeoJSON specification, properties field may be set for every Feature object. The map data will use all of the Simple Style properties, such as title, description, fill, and others. Additionally, the title, description fields may be either strings or localized string objects (similar to the localized type in tabular data). This allows the same map data to appear differently depending on the user's language.

Использование

Основная страница: Help:Extension:Kartographer

Use ‎<mapframe> and ‎<maplink> tags to show a map together with the custom map data defined in the .map page. For that, add this wiki markup (or similar ‎<maplink> but without the width and height) to any wiki page in any project, and the content of the Data:Sample.map page from Commons will be drawn. The content will be localized based on the user's interface language settings.

<mapframe width=500 height=350 zoom=11 latitude=40.8 longitude=-74>
{
  "type": "ExternalData",
  "service": "page",
  "title": "Sample.map"
}
</mapframe>

While not a very common usage scenario, a Lua script on any wiki can get map data by calling mw.ext.data.get("Example.map"). The function returns data in almost the same format as the original JSON, except that all localized strings will be converted to regular strings, and the license field will also include a localized license name. To get the data in another language, pass language code as the second parameter. To get the data in the original, unmodified form, use "_" as the language code.

Примеры

Map

Simple map

<mapframe width=200 height=200 zoom=11>
{
  "type": "ExternalData",
  "service": "page",
  "title": "Neighbourhoods/New York City.map"
}
</mapframe>

Map in Infobox

|map={{maplink|frame=yes|plain=yes|frame-align=center|frame-width=290|frame-height=200|type=line|from=Neighbourhoods/New York City.map}}
|map_custom=yes

Sample map data

{
    "license": "CC0-1.0",
    "description": { "en": "Manhattan Neighborhoods" },
    "sources": "http://example.com and [[Data]] page",
    "zoom": 11,
    "latitude": 40.8,
    "longitude": -74,
    "data": {
        "type": "FeatureCollection",
        "features": [
            {
                "type": "Feature",
                "properties": {
                    "title": {"en":"Alphabet City", "ru":"Алфабет-сити"}
                },
                "geometry": {
                    "type": "Polygon",
                    "coordinates": [[
                    	[-73.980356454849,40.730425548938],
    ...

full map code

Restrictions and gotchas

  • Each string value except the "sources" must be no more than 400 symbols long. Special characters like new lines \n and tabs \t are not allowed.
  • The overall size of the page may not exceed 2 MB.
  • Retrieving lines or shapes via Wikidata IDs within a data page will cause the map to break when it is called via maplink or mapframe. A workaround is to add the IDs directly in the maplink or mapframe code:
<mapframe width="500" height="500">
 [
  {
   "type": "ExternalData",
   "service": "geoshape",
   "ids": "Qxxxxx"
  },
  {
   "type": "ExternalData",
   "service": "page",
   "title": "Sample.map"
  }
 ]
</mapframe>

The sources are drawn in the order in which they are listed in the code—in the example above, the geoshape from Wikidata will appear beneath the components from the data page. This would be reversed if the data page was called before the Wikidata ID.

См. также