Modèl:Map draw

 Documentacion[modificar] [purgar]

Creatz (exemple detalhat) la sospagina qu'assegurarà lo seguiment del processús de traduccion en clicant sus Projècte:Traduccion/Map draw.

Modèl per dessenhar d'objècte sus una mapa amb de punts d'interès, linhas e poligòns. Cliclant dessús, la mapa dinamica s'amplia per obtenir informacion per cada objècte.

Aquel modèl es una ajuda per construir la sintaxi geoJSON de l'extension Kartographer amb una estructura flexibla de paramètres. Se pòt calcular cèrtas valors automaticament o generadas dempuèi Wikidata.

Sintaxi simpla per un sol objècte:

{{map draw}} mòstra una mapa estandard amb las coordenadas de l'article sus Wikidata.

{{map draw | coordenadas }}

Sintaxi complèta:

{{map draw
    |type= |latitude= |longitude=  |zoom= 
    |height= |width= |text= |align= |frameless= |class= |item=
    |coordinates= |title= |description= |image= 
    |marker-color= |marker-size= |marker-symbol=
    |stroke= |stroke-width= |stroke-opacity=
    |fill= |fill-opacity=
    |geotype= |ids=
        |geotype1=Point |coordinates1/ids1= |marker-color1= |marker-size1= |marker-symbol1= |title1/description1/image1= 
        |geotype2=LineString |coordinates2/ids2= |stroke2= |stroke-width2= |stroke-opacity2= |title2/description2/image2= 
        |geotype3=Polygon |coordinates3/ids3= |fill3= |fill-opacity3= |stroke3= |stroke-width3= |stroke-opacity3= |title3/description3/image3= 
        |geotype4=circle |radius4/radiuskm4 = |coordinates4/ids4= |edges4 |turn= |fill4= |fill-opacity4= |stroke4= |stroke-width4= |stroke-opacity4= |title4/description4/image4= 
        |geotype5=geoshape/geomask/geoline |ids5= |fill5= |fill-opacity5= |stroke5= |stroke-width5= |stroke-opacity5= |title5= |description5= |image5= 
        |geotype6=page |commons6= 
        |geotype7=named |from7= 
        |...
}}

Las coordenadas son l'unica donada requerida, o ben especificadas dins lo paramètre o ben disponiblas sus Wikidata. Per objèctes extèrnes geotype es requerit. Totes los autres paramètres son opcionals.

Los paramètres numerats son utils per combinar diferents objèctes. Devon seguir una numeracion correlativa a partir del primièr.

Donadas de la mapa

• item (opcional): ligam connectat amb Wikidata d'ont son tiradas las valors per defaut.
• type (opcional): tipe de representacion. Valors:
  • type =mapframe (per defaut): genera un mapa estatica dins una marcs com a vista prealable per accedir a la mapa dinamica.
  • type =maplink: mòstra un ligam per la mapa amb una icòna e un tèxte.
• latitude / longitude (opcional): Coordenadas del centre de la mapa a representar, en version decimala. Per defaut calcula lo centre de totes los punts representats, solament serà necessari se se vòl centrar la mapa en un altre punt.
• zoom (opcional): nivèl de zoom del mapa (0-18): 0=mapa mond, 9-11=region, 13=ciutat, 19=edifici. Per defaut calcula lo zoom minimal per encabir totes los punts dins lo cadre definit per height e width. Per un sol punt utiliza lo paramètre default_zoom o ben per defaut 9.

Dades per mapframe:

• height / width (opcional): auçada e largor de la mapa en pixels. Per defaut es 300 (300px x 300px), la mesura abituala dins las infotaulas e apropiada pels dispositius mobils.
• text (opcional): tèxte al pè de la mapa.
• align (opcional): alinhament de la mapa. Valors: left, center, right. Per defaut es right.
• frameless (opcional): amb quin que siá valor mòstra la mapa sens cadre. Es incompatible amb lo paramètre text.
• item (opcional): element de Wikidata d'on s'obten las donadas de coordenadas e aira. Per defaut utiliza l'element associat a la pagina. Non caldrà se ja las coordenades centralas son definidas o ben diferents objèctes son incluses.

Donadas per maplink:

• text (opcional): tèxte del ligmam. Per defaut mostrarà las coordenadas en cas d'un sol objècte introduit.
• class (opcional): format CSS a aplicar amb una class que siá definida sus Mediawiki:Common.css, per exemple class=infobox. Amb class=no-icon non mòstra la icona davant lo ligam.

Donadas dels objèctes

Se pòt definir mai d'un objècte numerant los paramètres N correlativament a partir del primièr. A fauta de far existir lo paràmetre N, prendrà la valor del paramètre sens cap de numeracion.

Paramètres comuns a totes los tipes d'objèctes:

• geotype / geotypeN: tipus d'objècte. Valors:
  • Per objèctes dissenhats (opcional): Point, MultiPoint, LineString, Polygon, circle. S'obten a partir del format de las coordenadas. Només és necessari en el cas MultiPoint que té el mateix format que LineString. El tipus circle genera un format Polygon de 32 cares.
  • Per objectes externs importats d'OpenStreetMap amb "ids" de Wikidata (opcional si és l'ítem associat):
    • geoshape: polígon amb l'àrea interior marcada,
    • geomask: polígon amb l'àrea exterior marcada,
    • geoline: polígon amb només la línia de contorn; per a objectes lineals funciona en pocs casos, pendent de phab:T156433.
  • Per objectes externs importats de Commons en l'espai Data: i l'extensió .map:
    • page (opcional) ajustat per clarificacion, amb el paràmetre "commons" ja utiliza geotype=page.
  • Per las coordenadas d'una pàgina definides amb (tagalog):
    • named, obten las coordenadas dels modèls coord amb lo paramètre name per tractar-las coma MultiPoint.
  • Per saltar-se un objecte, en cas de múltiples objectes consecutius definits de forma condicional:
    • geotypeN=none, ignora totes les definicions per l'objecte N.
• coordinates / coordinatesN (opcional): Coordenades en versió decimal. Com alternativa per un sol objecte pot ser el primer paràmetre sense nom. Per defecte l'obté de Wikidata. Per a dades externes no s'usa. Formats:
  • Un punt: amb el format «latitud , longitud».
  • Una linha o multipunt: consta de diversos punts amb les coordenades separades per un punt i coma: «punt ; punt...»
  • Un polígon: és una línia de contorn amb la darrera coordenada igual a la primera per tancar-lo. Un forat en l'interior de l'àrea és un altre polígon separat per dos punts: «línia_contorn : línia_contorn...»
• idsN (opcional): com alternativa a coordinatesN per obtenir-les del Qid de Wikidata. Per a línia, multipunt o polígon poden ser diversos valors separats per una coma. Per a dades externes té una altra funció, vegeu més avall.
• title / titleN (opcional): Títol de l'etiqueta de l'objecte.
• description / descriptionN (opcional): Descripció de l'objecte, com a subtítol en l'etiqueta.
• image / imageN (opcional): Imatge en l'etiqueta de l'objecte, amb el nom del fitxer sense prefix.

Dades per a punts

• marker-color / marker-colorN (opcional): Color del marcador del punt amb format CSS. Per defecte és "#7e7e7e". Vegeu la llista de colors.
• marker-size / marker-sizeN (opcional): Mida dels marcadors. Valors: small, medium, large; per defecte és medium.
• marker-symbol / marker-symbolN (opcional): Símbol dins del marcador, per defecte cap. Valors:
  • marker-symbol(N) = -number, numera correlativament tots els punts. També accepta un número determinat entre 0 i 9.
  • marker-symbol(N) = -letter, marca els punts amb lletres A, B, C... També accepta una lletra determinada entre a i z, en minúscula.
  • marker-symbol(N) = icona, amb el nom d'una de les icones disponibles: Modèl:Map draw/ús/Maki Icons.

Dades per a línies

• stroke / strokeN (opcional): Color de la línia amb format CSS. Per defecte és "#555555". Vegeu la llista de colors.
• stroke-width / stroke-widthN (opcional): Amplada de la línia amb valor numèric igual o major a 0, per defecte 2.
• stroke-opacity / stroke-opacityN (opcional): Opacitat de la línia amb valor decimal entre 0 i 1, per defecte 1.0.

Dades per a polígons

• fill / fillN (opcional): Color del polígon, excepte forats, amb format CSS. Per defecte és "#555555". Vegeu la llista de colors. En cas de geotype=geoshape és de l'interior del polígon, en cas de geotype=geomask és l'exterior.
• fill-opacity, fill-opacityN (opcional): Opacitat del polígon amb valor decimal entre 0 i 1, per defecte 0.6. En cas de geotype=geoshape és de l'interior del polígon, en cas de geotype=geomask és l'exterior.

També utilitza stroke / stroke-width / stroke-opacity per la línia de contorn del polígon.

Dades per a cercles

• radius / radiusN (necessari): Radi del cercle en metres. Amb les coordenades com a centre genera un polígon regular sobre la figura del cercle.
• radiuskm / radiuskmN: Valor alternatiu a radius expressat en quilòmetres.
• edges / edgesN (opcional): Número de cares del polígon. Per defecte són 32, en general suficients per aproximar a un cercle.
• turn / turnN (opcional): Gir del polígon amb valor entre 0 i 1. Per defecte és 0 generant el primer punt del polígon als 0º del cercle. Per exemple amb edges=3 i turn=0.5 inverteix el triangle amb el primer punt a 180º.

A més, utilitza els mateixos paràmetres que un polígon.

Dades per a objectes externs

• ids / idsN (opcional) d'OSM: identificador de l'element de Wikidata (Q...) Poden ser diversos identificadors separats per una coma. Per defecte obté l'identificador de la pàgina actual. Amb aquest identificador obté l'objecte d'OpenStreetMap si allà està definida la propietat wikidata=Q... Es poden utilitzar també els paràmetres per a polígons.
• commons / commonsN: títol del fitxer de Commons sense el prefix "Data:" i amb l'extensió ".map". Vegeu c:Special:Allpages/Data: i mw:Help:Map Data.

Donadas per las coordenadas d'una pagina

Amb geotype=named,

• from / fromN (opcional): títol de la pàgina, per defaut l'actual. Pòt inclure una seccio per mai d'eficiéncia del procès de transclusion de donadas. Tanben utiliza los paramètres pels punts.

Resumit e especificacions sus l'obtencion del zoom de la mapa.

• Si hi ha més d'una coordenada, sigui més d'un punt, o una línia o un polígon, calcula el centre del mapa i el zoom per encabir-hi totes les coordenades. Obté els extrems dels quatre punts cardinals. Calcula el centre geogràfic dels quatre extrems. Calcula les distàncies màximes de latitud i longitud, tenint en compte que les distàncies varien segons la latitud. Calcula el zoom mínim, entre 19 i 0, per a que les distàncies hi entrin en els valors height i width de la finestra. Aquesta finestra té un marge no útil de 50px per la icona de maximitzar de dalt a la dreta, la icona de zoom en previsualització a dalt a l'esquerra i el peu amb els crèdits.
• Si només hi ha una coordenada, sigui perquè només s'ha definit un punt, o bé perquè s'ha obtingut de Wikidata, cosa que també passa quan s'usen dades externes d'OSM o de Data Commons sense tenir el detall de les coordenades, el procés és el següent, per ordre:

1. El valor del paràmetre zoom.
2. Obtenció de ²⁰⁴⁶ o de ^P2053, fent conversió d'unitats si és necessari. S'aproxima la superfície a un cercle i s'obtenen els quatre extrems. (Segueix amb els mateixos càlculs de més amunt).
3. Obtenció de ^P1082 i càlcul de l'àrea estimant una densitat mitjana per a zones habitades de 100 hab/m² (vegeu en:Population density). (Segueix amb els mateixos càlculs de més amunt).
4. Repetició dels punts 2 i 3 aplicats a l'element ^P131. Per exemple un edifici o una muntanya no tindran ni superfície ni població i s'aplica l'àrea de la seva unitat administrativa.
5. El valor del paràmetre default_zoom.
6. Valor per defecte final de 9.

• Mòdul:Map amb lo còdi de supòrt del modèl.
• mw:Help:Extension:Kartographer, ajuda de l'extension Kartographer.
• Especificacion simplestyle, version de GeoJSON utilizada.
• Generacion de fichièrs Map Data a partir d'una mapa creada amb {{map draw}}