Format:Maplink/doc

Aceasta este pagina de documentație pentru Format:Maplink.
Pagina descrie modul de folosire al formatului și conține categoriile de care acesta aparține, precum și orice altceva ce nu face parte din formatul propriu-zis.

Utilizează Lua:

Modul:Mapframe

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}}.
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}}}}
San Francisco International Airport

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.

</includeonly>

PROFILPELAJAR.COM