Help:Extension:Kartographer/gl

Estas páxinas de documentación de como usar Kartographer extension e o seu  e  etiquetas.

Primeiros pasos
 Este código inserirá un mapa interactivo simple(como o que ves á dereita), ca posibilidade de maximizalo por calquera que prema no mapa o faga click na icona da esquina dereita.

Ao  o parámetro de alineación por defecto á esquerda, dereita ou centro.

The attribute   allows for zoom levels between 0 and 19. Zero is the furthest out, 19 the furthest in.

Uso
 { "type": "Feature", "geometry": { "type": "Point", "coordinates": [-122.3988, 37.8013] }, "properties": { "title": "Exploratorium", "description": "", "marker-symbol": "museum", "marker-size": "large", "marker-color": "0050d0" } }

O contido de etiquetas non pode ser baleiro ou invalidará GeoJSON co estilo, cando é producido por GeoJSON editor. Axuda cartográfica en simplestyle specification con Maki icons (Licenciado baixo Creative Commons Zero).

Frames
Frameless maps are good for insertion as part of a template, whereas framed maps are good for insertion directly into the page, either by hand or by using the visual editor.


 * To insert a map without a frame, add the "frameless" attribute:
 * To add a caption, use the  attribute.

Note: Adding the text attribute automatically enables a frame, even if there is a  attribute.

==

tamén acepta un parámetro extra "texto" a especificar na ligazón de texto insertado nas coordenadas:

A etiqueta pode conter o mesmo geojson coma.

=== attribute. Sen este atributo, as coordenadas serán mostradas (exemplo:  é un xogo máxico   ou valor   . Neste caso cada   será remplazado cun contador incremental , e   con   valores.

Se GeoJSON ten máis dun contador, o valor do primeiro o amosado no ligazón de texto. Opcionalmente, editores poden engadir un sufixo habendo mútiples contadores na páxina nalgúns casos. Esta vía  terá diferente contador dende.

Tería sentido utilizar unha cor distinta para cada conta de grupo. Todoa a información engadida vía amosará tódolos mapas inseridos con, a non ser que se empreguen atributos de.

podería ser ampliado en

Os atributos, e   controlan a localización do mapa despregable. Usa  para a ligazón ao texto (podería ser calquera válido como marcador). Usa  para engadir contido a esta etiqueta nomeando o grupo (mira embaixo).

Grupos
Para o uso do proxecto Wikivoyage, hai unha necesidade de amosar o mapa ca data definida nalgures máis da páxina. Por exemplo, hai múltiples puntos de interese (POI) definido con etiquetas no, e nun mapa común sobre o lugar na páxina onde amosar todo.

O concepto de agrupación deixa aos editores para compartir datos entre múltiples etiquetas e.

Por defecto, a data na etiqueta ou  amosadas só para unha etiqueta, e non amosará nada máis.

Se ou  especifican   do atributo, a data dentro das etiquetas poden ser ubicadas no nome do grupo, xunto con outra información para o nome do grupo. Como o resultado, algunhas etiquetas con nome do grupo amosado na información dalgún mapa, e cada etiqueta pode incrementar a información engadida ao grupo.

Unha etiqueta pode amosar outros grupos, custe o que custe se pertence a un grupo ou non, pode especificar o tributo a. Ca coma separa múltiples nomes de grupos especificados. O nome do grupo pode só conter o caso máis baixo de letras en inglés. Esta matriz amosa que información pode amoser cada tag.

Información externa
 { "type": "ExternalData", "service": "geoshape", "ids": "Q797" }

Alén de debuxar polígonos que utilizan GeoJSON, podes tamén conseguir esbozos dos obxectos xeográficos ben coñecidos en Wikidata ID se son marcados os cales na base de OpenStreetMap. Por exemplo, o item en wikidata para Alaska é Q797, e nón podemos debuxalo no mapa usando "información externa" da referencia. Máis dun ID pode ser especificado separado cunha coma. Para crear unha máscara sobre as áreas de interese, usan o servizo "geoshape". A invertir esto e crea unha máscara sobre todo o demáis, usa o servizo "geomask".

GeoShapes via Wikidata Query
 { "type": "ExternalData", "service": "geoshape", "query": " SELECT ?id ?head (SAMPLE(?img) as ?img)   (min(?partyId) as ?party)   (if(?party = '0', '#800000', if(?party = '1', '#000080', '#008000')) as ?fill)  (concat(, ?headLabel, ) as ?title)  (concat(?stateLabel, '\\n', '') as ?description) WHERE {    ?id wdt:P31 wd:Q35657 .  ?id wdt:P6 ?head .  ?head wdt:P102 ?party .  BIND(if(?party = wd:Q29468, '0', if(?party = wd:Q29552, '1', '2')) as ?partyId)   SERVICE wikibase:label {    bd:serviceParam wikibase:language 'en' .    ?head rdfs:label ?headLabel .    ?id rdfs:label ?stateLabel .  }  OPTIONAL {    ?head wdt:P18 ?img .  }  ?link schema:about ?head .  ?link schema:isPartOf  . } GROUP BY ?id ?head ?headLabel ?link ?stateLabel "}

While this helps with the simple use cases when the Wikidata ID is well known, sometimes you may want to get a list of IDs as a result of a Wikidata query. A SPARQL query gets a list of all US states in the ID column of the result, and geoshapes service adds the geometrical outlines for each state. All other columns in the SPARQL query result become values in the "properties" object. The "fill" column changes the color of the state. The "title" column shows state governor's name, and "description" has wiki markup to show the state name and the governor's picture. To edit this query, copy the query parameter after the "#" symbol at ''' https://query.wikidata.org/#... ''':

Map data from Commons

 * Further information: 

Map data stored on Commons can be drawn on the map. For example, c:Data:Neighbourhoods/New York City.map:  { "type": "ExternalData", "service": "page", "title": "Neighbourhoods/New York City.map" }

Combining multiple data types
 [ {    "type": "ExternalData", "service": "geoshape", "ids": "Q13518258", "properties": { "stroke": "#ffb100", "stroke-width": 6, } },  {    "type": "Feature", "geometry": { "type": "Point", "coordinates": [4.75566, 44.104498] }, "properties": { "title": "Porte de Castellan" } },  {    "type": "Feature", "geometry": { "type": "Point", "coordinates": [4.75829, 44.10258] }, "properties": { "title": "Porte Léon Roche" } } ] You can combine ExternalData, Feature, and FeatureCollection together in the same &lt;mapframe> or &lt;maplink> element:

 [ {    "type": "ExternalData", "service": "page", "title": "Neighbourhoods/New York City.map" }, {    "type": "ExternalData", "service": "geoshape", "ids": "Q160409", "properties": { "fill": "#07c63e", "title": "Central Park" } },  {    "type": "Feature", "properties": {"title": "Roosevelt Island", "marker-color": "f01080"}, "geometry": { "type": "Point", "coordinates": [ -73.94511222839355,       40.76734665426719      ]    }  } ] Map data from commons can be combined with other types of data:

Styling Wikidata ID elements
 { "type": "ExternalData", "service": "geoline", "ids": "Q2108", "properties": { "title": "Highway I-696", "description": "", "stroke": "#ffb100", "stroke-width": 8 } } For external data, you can also add styles and titles, using the properties keyword:

The main style keys are: "stroke" (color), "stroke-width", "stroke-opacity", "fill" (color), "fill-opacity".

Overlapping elements
Map elements that overlap are drawn in the order in which they are written in the code. For instance, if a map includes two lines that overlap, the line that is defined first will appear beneath the line that is defined second. The following examples show how this can affect the appearance of the map:  { "type": "FeatureCollection", "features": [ { "type": "Feature", "properties": {"fill": "#ff0000","fill-opacity": 0.7,"stroke-width": 0}, "geometry": { "type": "Polygon", "coordinates": [ [ [ 77.926025390625, -25.150257104114733 ], [ 80.14251708984374, -25.150257104114733 ], [ 80.14251708984374, -24.43714786161562 ], [ 77.926025390625, -24.43714786161562 ], [ 77.926025390625, -25.150257104114733 ] ] ] } }, { "type": "Feature", "properties": {"stroke": "#fffa00","stroke-width": 5}, "geometry": { "type": "LineString", "coordinates": [ [ 77.926025390625, -25.150257104114733 ], [ 80.14251708984374, -24.43714786161562 ] ] } }, { "type": "Feature", "properties": {"stroke": "#000000","stroke-width": 5}, "geometry": { "type": "LineString", "coordinates": [ [ 77.926025390625, -24.43714786161562 ], [ 80.14251708984374, -25.150257104114733 ] ] } } ] } The code for the map above includes three elements, all of which use GeoJSON's "feature" functionality. The first feature is a "Polygon" - the red rectangle. This is followed by two "LineString" features. The yellow line is defined first, so it appears beneath the black line. Note that the hierarchy used to draw elements applies regardless of whether the data is raw GeoJSON or comes from a Wikidata ID or Commons data page.

The map below changes the order from that of the first example: the black line is defined first and is thus moved to the bottom of the stack:  { "type": "FeatureCollection", "features": [ { "type": "Feature", "properties": {"stroke": "#000000","stroke-width": 5}, "geometry": { "type": "LineString", "coordinates": [ [ 77.926025390625, -24.43714786161562 ], [ 80.14251708984374, -25.150257104114733 ] ] } }, { "type": "Feature", "properties": {"fill": "#ff0000","fill-opacity": 0.7,"stroke-width": 0}, "geometry": { "type": "Polygon", "coordinates": [ [ [  77.926025390625,  -25.150257104114733  ],  [  80.14251708984374,  -25.150257104114733  ],  [  80.14251708984374,  -24.43714786161562  ],  [  77.926025390625,  -24.43714786161562  ],  [  77.926025390625,  -25.150257104114733  ]  ]  ]  } }, { "type": "Feature", "properties": {"stroke": "#fffa00","stroke-width": 5}, "geometry": { "type": "LineString", "coordinates": [ [ 77.926025390625, -25.150257104114733 ], [ 80.14251708984374, -24.43714786161562 ] ] } } ] }

Rendering options
The following table shows how a map can be formatted for display on a wiki page. The table contains two columns: the first shows an interactive map via the tag, and the second showing the rendering of an example image with the same options.

Internationalization
Map labels for locations are localized. By default the map will be in the same language as the page it is embedded it. If that is not available then the configured fallback(s) in MediaWiki for that language. If the label is not available in that language, then English. Finally, if nothing else is available, then the local name is used.

Translations to the OSM data are welcome.