Format:Maplink

Maplink

Documentația formatuluiafișeazămodificăistoricregenerează

Acest format adaugă o legătură sau un cadru care va afișa o hartă din OpenStreetMap împreună cu datele specificate. Harta și datele se pot vizualiza într-o fereastră fullscreen zoomabilă și scrollabilă. Datele hărții pot proveni din:

• date stocate în format GeoJSON pe Wikipedia sau Commons
• caracteristici de tip linie/poligon din OpenStreetMap.
• coordonate, fie furnizate direct, fie de la Wikidata
• GeoJSON brut, de preferat transclus din altă pagină

Atenție:

• Dacă aveți o hartă foarte mare/lentă, folosiți direct tagul de extensie mapframe în locul acestui format, așa cum s-a făcut la en:Special:Diff/970846012. Motivul este că folosirea acestui format pentru a apela tagul extensiei face ca redarea hărții să fie numărată ca timp Lua, ceea ce poate da erori de depășire a timpului.
• Fișierele GeoJSON nu pot fi încărcate direct. Creați, în schimb, pe Commons, o pagină în spațiul de nume Data: și cu numele terminându-se în .map – vezi mw:Help:Map Data pentru mai multe informații.
• Pentru a face disponibile caracteristicile OpenStreetMap (OSM), adăugați cheia de Wikidata la relația OSM (și așteptați o zi sau două) – vezi mw:Help:Extension:Kartographer#External_data, mw:Help:Extension:Kartographer/OSM și en:Module talk:mapframe/FAQ pentru mai multe informații.

Puteți folosi {{infobox mapframe}} pentru a gnera o hartă mapframe care poate fi inclusă în infocasete, cu date minimale.

Utilizări

Acest format are ca scop afișarea de puncte, dar și de caracteristici liniare sau poligonale de pe o hartă, inclusiv (dar nu numai):

• Drumuri
• Râuri
• Linii de tren sau metrou
• Trasee de navigație maritimă
• Rute ale unor zboruri
• Călătorii ale unor exploratori
• Habitatele unor animale
• Țări și subdiviziunile lor

și altele... Acest format se poate folosi pentru a afișa și puncte pe hartă, cum ar fi coordonate.

Utilizare

Utilizare de bază

• Data page pe Commons (de ex. Data:ecos.fws.gov/Endangered habitat 58938/Plethodon neomexicanus.map):

  {{maplink|from=}} (specificați pagina de date .map în from=, excluzând prefixul Data)

• maplink: Nu pot parsa JSON: Eroare de sintaxă
  (de ex. {{Wikipedia:Map data/Main Roads Western Australia/Forrest Highway}}):

  {{maplink|raw=}} (specificați GeoJSON brut, de preferat transclus dintr-o subpagină a paginii Wikipedia:Date hărți)

• Linie a unui contur sau caracteristică liniară din OSM:

  {{maplink|type=line|id=}} (ID-ul de Wikidata este necesar doar dacă se folosește în altă pagină decât a lui)

• Formă din OSM:

  {{maplink|type=shape|id=}} (ID-ul de Wikidata este necesar doar dacă se folosește în altă pagină decât a lui)

• Inverted shape from OSM:

  {{maplink|type=shape-inverse|id=}} (ID-ul de Wikidata este necesar doar dacă se folosește în altă pagină decât a lui)

• Caracteristică punctiformă (coordonate):

  ...din Wikidata:
  {{maplink|type=point|id=}} (ID-ul de Wikidata este necesar doar dacă se folosește în altă pagină decât a lui)

  ...din coordonate specificate:
  {{maplink|type=point|coord=}} (specificați coordonatele folosind formatul {{Coord}})

• maplink: Titlul "Netherton Tunnel Branch Canal" nu este o pagină validă cu date pentru hărți
  dintr-o pagină sau secțiune (formate {{coord}} folosind parametrul |name=)

  ...din pagina curentă: {{maplink|type=named}} sau {{maplink|type=named|from=#Section}}

  ...din altă pagină: {{maplink|type=named|from=Other page}} sau {{maplink|type=named|from=Other page#Section}}

• maplink: The JSON content is not valid GeoJSON+simplestyle. The list below shows all attempts to interpret it according to the JSON Schema. Not all are errors.

  • /0/ids
    Does not match the regex pattern ^Q[1-9]\d{0,19}(\s*,\s*Q[1-9]\d{0,19})*$
  • /0/ids
    String value found, but an array is required
  • /0/ids
    Failed to match exactly one schema
  • /0/title
    The property title is required
  • /0/service
    The property service is required
  • /0
    Failed to match exactly one schema
  • /0/geometries
    The property geometries is required
  • /0/type
    Does not have a value in the enumeration ["GeometryCollection"]
  • /0/type
    Does not have a value in the enumeration ["MultiPolygon"]
  • /0/type
    Does not have a value in the enumeration ["Point"]
  • /0/type
    Does not have a value in the enumeration ["MultiPoint"]
  • /0/type
    Does not have a value in the enumeration ["LineString"]
  • /0/type
    Does not have a value in the enumeration ["MultiLineString"]
  • /0/type
    Does not have a value in the enumeration ["Polygon"]
  • /0/coordinates
    The property coordinates is required
  • /0/geometry
    The property geometry is required
  • /0/type
    Does not have a value in the enumeration ["Feature"]
  • /0/features
    The property features is required
  • /0/type
    Does not have a value in the enumeration ["FeatureCollection"]
  (centrat pe coordonatele unui punct):

  ...din Wikidata:
  {{maplink|type=circle|radius=|id=}} (ID-ul de Wikidata este necesar doar dacă se folosește în altă pagină decât a lui)

  ...de la coordonate specificate:
  {{maplink|type=circle|radius=|coord=}} (specificați coordonatele folosind formatul {{Coord}})

• Pentru a afișa într-un frame, adăugați parametrul |frame=yes: {{maplink|frame=yes|frame-align=left|type=line|id=Q1094308|text=Mapframe example}}.
  

• Sunt disponibili și alți parametri pentru a personaliza harta afișată, cum ar fi |plain=yes care înlătură chenarul exterior: {{maplink|frame=yes|frame-align=left|plain=yes|type=line|id={{get QID|Várkerület}}|frame-width=200|frame-height=250|frame-long=19.1009|frame-lat=47.5001|zoom=9}}.
  
  mapframe: The JSON content is not valid GeoJSON+simplestyle. The list below shows all attempts to interpret it according to the JSON Schema. Not all are errors.

  • /0/ids
    Does not match the regex pattern ^Q[1-9]\d{0,19}(\s*,\s*Q[1-9]\d{0,19})*$
  • /0/ids
    String value found, but an array is required
  • /0/ids
    Failed to match exactly one schema
  • /0/title
    The property title is required
  • /0/service
    Does not have a value in the enumeration ["page"]
  • /0
    Failed to match exactly one schema
  • /0/geometries
    The property geometries is required
  • /0/type
    Does not have a value in the enumeration ["GeometryCollection"]
  • /0/type
    Does not have a value in the enumeration ["MultiPolygon"]
  • /0/type
    Does not have a value in the enumeration ["Point"]
  • /0/type
    Does not have a value in the enumeration ["MultiPoint"]
  • /0/type
    Does not have a value in the enumeration ["LineString"]
  • /0/type
    Does not have a value in the enumeration ["MultiLineString"]
  • /0/type
    Does not have a value in the enumeration ["Polygon"]
  • /0/coordinates
    The property coordinates is required
  • /0/geometry
    The property geometry is required
  • /0/type
    Does not have a value in the enumeration ["Feature"]
  • /0/features
    The property features is required
  • /0/type
    Does not have a value in the enumeration ["FeatureCollection"]

• Se pot afișa și overlay-uri peste hartă: {{maplink|frame=yes|frame-align=left|frame-width=400|frame-height=300|type=point|id=Q8688|marker=airport|zoom=12 |text=San Francisco International Airport |overlay={{Graph:Street map with marks|width=110|height=90|lat=37.8|lon=-121.8|zoom=6|{ "lat": 37.618, "lon": -122.375 }| minimap=false}}}}
  

Set de parametri – pagină de date

{{maplink
|display=
|from=
|zoom=
|text=
|icon=
}}

Set de parametri – date brute

{{maplink
|display=
|raw= <!-- preferably {{Wikipedia:Map data/subpage}} -->
|zoom=
|text=
|icon=
}}

Set de parametri – geoline/geoshape

{{maplink
|display=
|type=
|id=
|title=
|description=
|stroke-color=
|stroke-width=
|zoom=
|text=
|icon=
}}

Set de parametri – coordonate/caracteristici punctiforme

{{maplink
|display=
|type=point
|id=
|title=
|description=
|coord=
|marker=
|zoom=
|text=
|icon=
}}

Set de parametri – cercuri

{{maplink
|display=
|type=circle
|radius=  <!-- în metri --> 
|id=
|title=
|description=
|coord=
|marker=
|zoom=
|text=
|icon=
}}

Parametri

Pentru afișarea generală

display

Cum se afișează formatul. Valori valide:

inline - Afișează doar legătura (implicit)

title - Afișează doar titlul

inline,title - Afișează linkul și titlul

title,inline - ca mai sus

text

Text de afișat pentru link (sau descriere dacă se folosește mapframe); implicit e "Hartă"

icon

Setați la "no" pentru a elimina pictograma de lângă link

zoom

Nivelul de zoom, de la 1 la 19 (numerele mai mari înseamnă zoom mai apropiat); implicit, se determină automat de pe hartă, dacă caracteristica nu este un singur punct.

Parametri Mapframe (funcționează doar cu display inline)

frame

Setați la "yes" pentru a afișa un cadru de hartă în loc de link

plain

Setați pe "yes" pentru a afișa doar harta fără cadrul înconjurător, și fără descriere (parametrul text va fi ignorat)

frame-align

Aliniere în raport cu pagina: left, center, sau right; implicit este right

frame-width

Lățimea hărții în pixeli, implicit este 300

frame-height

Înălțimea hărții în pixeli, implicit este 200

frame-coordinates

(sau frame-coord)

Opțional - coordonatele centrului hărții. Folosiți {{Coord}} pentru a specifica coordonatele (e.g. |frame-coordinates={{Coord|12.34|S|56.78|W}}). Dacă nu este setat, coordonatele se extrag de la Wikidata.

frame-latitude

(sau frame-lat)

(ignorat dacă este setat |frame-coordinates= sau |frame-coord=)

Opțional - coordonata de latitudine pentru centrul hărții.

frame-longitude

(sau frame-long)

(ignorat dacă este setat |frame-coordinates= sau |frame-coord=)

Opțional - coordonata longitudinii pentru centrul hărții.

Atenție: dacă nu sunt setați parametrii latitudinii și longitudinii, atunci coordonatele cadrului se pot determina automat, fie:

• Pe baza liniei și formei obiectelor (dacă s-a specificat vreunul), sau
• Din caracteristica punctiformă specificată la |coord= (dacă este setată), sau
• Extrasă de la Wikidata (dacă se poate – fie pentru itemul specificat la parametrul |id=, fie la pagina în care este plasat formatul)

overlay

O imagine, sau altă hartă, care să fie afișată peste hartă. De ex.

|overlay=Format:Elc sau

|overlay={{maplink|frame=yes|plain=yes|frame-width=100|frame-height=100|type=shape|id={{get QID|French submarine Ariane (1914)}}|frame-align=center}} sau

|overlay={{Graph:Street map with marks|width=100|height=100|lat=37.8|lon=-122.4|zoom=6|{ "lat": 37.8, "lon": -122.4 }|minimap=false}}

(vezi Template:Maplink/testcases/overlays pentru exemple)

overlay-horizontal-alignment

Aliniamentul orizontal al overlay-ului, fie left fie right; implicit este right

overlay-vertical-alignment

Aliniamentul vertical al overlay-ului, fie top fie bottom; implicit este bottom

overlay-horizontal-offset și overlay-vertical-offset

Opțional – numărul de pixeli cu care să se deplaseze overlay-ul de la marginea hărții, de ex. 10 pentru un spațiu de 10 pixeli

overlay-border

Stil CSS pentru chenar, de ex. 3px solid black; implicit este 1px solid white. Culoarea poate fi orice nume de culoare web sau cod hexa.

GeoJSON brut

raw

GeoJSON brut (de preferat transclus dintr-o subpagină a paginii Wikipedia:Date hărți) precum și funcționalitatea <maplink> disponibilă prin ceilalți parametri.

Pentru fiecare caracteristică

Se pot afișa multiple caracteristici pe o singură hartă. Pentru fiecare din ele, se adaugă un număr secvențial la sfârșitul numărului parametrului. De exemplu, al doilea va folosi parametri ca |type2=, |id2=, etc., al treilea: |type3=, |id3=, etc., și așa mai departe. Numerele mai mari se redau deasupra.

type

Tipul de date. Valori valide sunt:

line – o caracteristică geoline din OSM (de exemplu, un drum)

shape – o caracteristică geoshape din OSM (de exemplu o provincie)

shape-inverse – o caracteristică geomask din OSM (inversa lui geoshape - permite o vedere nestânjenită a hărții de dedesubt)

data – o pagină de date geoJSON de pe Commons (parametrul este opțional în acest caz)

point – o caracteristică punctiformă (coordonate)

named – toate coordonatele cu nume dintr-o pagină sau secțiune (formate {{coord}} cu parametrul |name=)

circle – un cerc cu centrul în coordonatele unui punct

id

(sau ids)

ID Wikidata (Q-număr) al caracteristicii punctiforme, ID Wikidata cu care este etichetată caracteristica OSM de tip linie/formă. ID-uri separate de virgulă. Implicit, este ID-ul paginii actuale de Wikidata (dacă nu este setat |from=).

from

Sursa datelor hărții:

• Dacă type este data sau lipsește: Fișierul JSON (.map) de pe Commons care să fie afișat (excluzând prefixul Data:)
• Dacă type este named: Numele paginii, sau nume#secțiune, de la care să se ia coordonatele. Dacă lipsește, sau este specificat drept doar #secțiune, atunci se folosește pagina curentă.

title

Titlul caracteristicii (pentru caracteristici din OSM), afișat când se face click pe caracteristică; implicit este titlul paginii

description

Descrierea caracteristicii (pentru caracteristici de la OSM), afișată când se face click pe caracteristică; opțional

stroke-color

(sau stroke-colour)

Codul culorii utilizate pentru a desena caracteristica (pentru caracteristici de la OSM); implicit este #ff0000 (roșu)

stroke-width

Grosimea liniei utilizate pentru a desena caracteristica (pentru caracteristici de la OSM); implicit este 6

stroke-opacity

Opacitatea liniilor folosite pentru a desena caracteristica (pentru caracteristici de la OSM) – un număr între 0 (complet transparent) și 1 (complet opac); implicit este 1

fill

Codul culorii pentru culoarea cu care se umple caracteristica (pentru caracteristici shape sau shape-inverse de la OSM); implicit este #000000 (negru). Implicit se folosește o versiune semitransparentă a culorii specificate, care permite să se vadă harta de dedesubt.

fill-opacity

Opacitatea culorii de umplere a caracteristicii (pentru caracteristici shape sau shape-inverse de la OSM) – un număr între 0 (complet transparent) și 1 (complet opac); implicit este 0.5

coord

Coordonatele de afișat pentru o caracteristică punctiformă. Folosiți formatul {{Coord}} pentru a specifica coordonatele (e.g. |coord={{Coord|12.34|S|56.78|W}}). Dacă nu este setat, coordonatele se vor lua de la Wikidata.

marker

Numele unei imagini de marker Maki de afișat la caracteristica punctiformă. Vezi mw:Maps/Icons pentru opțiuni. Dacă nu se setează, se folosește un marker simplu fără imagine.

marker-color

(sau marker-colour)

Codul culori (tripletă hexa) pentru culoarea de fundal a markerului. Implicit este 5E74F3 (    )

marker-size

Dimensiunea markerului. Poate fi small, medium (implicit) sau large.

radius

(sau radius_m) sau radius_km

Raza cercului. Implicit în metri.

edges

Numărul de muchii utilizate pentru a construi cercul. Implicit este 32. Numerele mai mare au ca rezultat un cerc mai bine conturat, dar vor folosi mai multe resurse de procesare Lua.

Documentația de mai sus este transclusă din Format:Maplink/doc. (modifică | istoric)
Editorii pot experimenta în paginile sandbox (creează | oglindește) și testcases (creează) ale acestui format.
Adăugați categorii la subpagina /doc. Subpagini ale acestui format.