Naar inhoud springen

Sjabloon:Map draw

Uit Wikipedia, de vrije encyclopedie
Sjabloondocumentatie[bekijk] [bewerk] [ververs] [geschiedenis]

Met dit sjabloon kunnen objecten op een kaart worden getekend, zoals punten, lijnen en vlakken. Door op de kaart op de pagina te klikken, wordt een interactieve kaart op volledig scherm geopend die gedetailleerde informatie over elk van de weergegeven objecten toont.\n\nDit is een tool die helpt bij het opbouwen van de GeoJSON-syntaxis die wordt gebruikt door de Kartographer-extensie en die een flexibele parameterstructuur biedt. Sommige waarden kunnen automatisch worden berekend of rechtstreeks uit Wikidata worden gehaald.

Syntaxis

Eenvoudige syntaxis voor één enkel object

  • {{map draw}}
Genereert een standaardkaart met behulp van de coördinaten uit het artikel op Wikidata.
  • {{map draw | coordinates }}
 Genereert een kaart gecentreerd op de aangegeven coördinaten.
  • {{map draw |latitude=|longitude=|zoom=|commons=}}
 Genereert een kaart met gegevens van Wikimedia Commons.

Volledige syntaxis

{{map draw
    |type= |latitude= |longitude=  |zoom= 
    |height= |width= |text= |align= |frameless= |class= 
    |coordinates= |title= |description= |image= 
    |marker-color= |marker-size= |marker-symbol=
    |stroke= |stroke-width= |stroke-opacity=
    |fill= |fill-opacity=
    |geotype= |ids=
        |geotype1=Point |coordinates1= |title1= |description1= |image1= |marker-color1= |marker-size1= |marker-symbol1=
        |geotype2=LineString |coordinates2= |title2= |description2= |image2= |stroke2= |stroke-width2= |stroke-opacity2= 
        |geotype3=Polygon |coordinates3= |title3= |description3= |image3= |fill3= |fill-opacity3= |stroke3= |stroke-width3= |stroke-opacity3= 
        |geotype4=(geoshape/geomask/geoline) |ids4= |title4= |description4= |image4= |fill4= |fill-opacity4= |stroke4= |stroke-width4= |stroke-opacity4= 
        |titleN= ...
    |commons= 
}}

Alleen de coördinaten zijn verplicht. Deze kunnen worden opgegeven in de bijbehorende parameter of, indien dat niet mogelijk is, worden verkregen via Wikidata. Voor geometrische vormen of externe objecten (externe geotypes) is de definitie ervan verplicht. Alle andere parameters zijn optioneel.

Met de genummerde parameters kunnen verschillende objecten op dezelfde kaart worden gecombineerd. Ze moeten opeenvolgend zijn in nummering en beginnen met 1.

Parameters

  • type (optioneel): Soort weergave.
    • type =mapframe (standaard): Genereert een statische kaart die in de pagina is ingesloten. Dit is wat direct in het artikel als voorbeeld kan worden gezien. Door erop te klikken, wordt de interactieve kaart op volledig scherm geopend met alle getekende objecten.
    • type =maplink: Toont (in plaats van een kaart) een pictogram en een link om de interactieve kaart te openen in een pop-upvenster of nieuw tabblad. Deze kan worden gebruikt wanneer je naar de locatie wilt verwijzen zonder de volledige kaart op te nemen in het artikel.
  • latitude / longitude (optioneel): Standaard wordt het middelpunt van alle weergegeven punten al berekend. Als je de kaart echter op een ander punt wilt centreren kun je dit hier opgeven met behulp van decimale coördinaten.
  • zoom (optioneel): Zoomniveau van de kaart, met bereik 0-18:
 - 0 = wereldkaart
 - 9-11 = regio
 - 13 = stad 
 - 18 = gebouw

Standaard wordt het minimale zoomniveau berekend dat nodig is om alle punten binnen het door height en width gedefinieerde kader weer te geven. Voor een enkel punt kan de parameter default_zoom worden gebruikt of de standaardwaarde 9.

Specifieke parameters voor mapframe (optioneel)

  • height / width: Kaarthoogte en -breedte in pixels. Standaard is dit 300x300 pixels, geschikt voor infoboxen en mobiele apparaten.
  • text: Onderschrift bij de kaart.
  • align: Kaartuitlijning. Waarden: «left», «center», «right». Standaard: «right».
  • frameless: Indien ingevuld met een waarde, toont dit de kaart zonder kader. Niet compatibel met de parameter text.
  • text: Tekst die in de link verschijnt. Standaard worden de coördinaten van één object weergegeven.
  • class: CSS-opmaak die moet worden toegepast met behulp van een klasse gedefinieerd in Mediawiki:Common.css, bijvoorbeeld class=infobox. De klasse no-icon haalt het pictogram weg die anders vóór de link wordt weergegeven.

Objectgegevens

Er kunnen meerdere objecten worden gedefinieerd door de parameters opeenvolgend te nummeren vanaf 1. Indien er geen nummering is, wordt de niet-genummerde parameter toegepast op het eerste object.

Gemeenschappelijke parameters voor alle objecttypen

  • geotype / geotypeN: Objecttype. Waarden:
    • Voor getekende objecten (optioneel): Point, MultiPoint, LineString, Polygon. Het type wordt bepaald door de coördinatenindeling. Alleen verplicht bij MultiPoint.
    • Voor externe objecten die vanuit OpenStreetMap zijn geïmporteerd met behulp van «ids» van Wikidata (verplicht):
      • geoshape: polygoon met vulling
      • geomask: polygoon waarbij het gebied eromheen gevuld is (ter maskering)
      • geoline: polygoon met enkel de contour (buitenlijn)
  • coordinates / coordinatesN (optioneel): Coördinaten in decimale vorm
    • Voor een enkel object kan dit worden gebruikt als de eerste naamloze parameter. Standaard worden de coördinaten opgehaald uit Wikidata.
      • Niet gebruiken voor externe gegevens.
    • Formaten:
      • Punt: «latitude,longitude»
      • Lijn of multipunt: meerdere punten gescheiden door puntkomma's: «punt; punt; …»
      • Polygoon: contourlijn waarbij de laatste coördinaat gelijk is aan de eerste. Interne gaten: een andere veelhoek gescheiden door dubbele punt: «contourlijn:contourlijn…»
  • title / titleN (optioneel): Titel van de label van het object
  • description / descriptionN (optioneel): Beschrijving van het object, dat als ondertitel verschijnt in het label.
  • image / imageN (optioneel): Afbeelding in het objectlabel: bestandsnaam zonder voorvoegsel 'Bestand:'.

Specifieke parameters: punten

  • marker-color / marker-colorN (optioneel): Markeringskleur in CSS-formaat. Standaard: "#7e7e7e" (lichtgrijs). Zie de kleurentabel.
  • marker-size / marker-sizeN (optioneel): Markeringsgrootte. Mogelijke waarden: small, medium, large. Standaard: medium.
  • marker-symbol / marker-symbolN (optioneel): Symbool. Standaardwaarde: leeg. Mogelijke waarden:
    • marker-symbol(N) = -number: nummert alle punten opeenvolgend; staat ook een getal tussen 0 en 9 toe.
    • marker-symbol(N) = -letter: markeert punten met de letters A, B, C…; accepteert letters tussen a en z.
    • marker-symbol(N) = pictogram: naam van een icoon beschikbaar in Maki-pictogrammen. Meer iconen op mw:Help:Extension:Kartographer/Icons.

Specifieke parameters: lijnen

  • stroke / strokeN (optioneel): Lijnkleur in CSS-formaat. Standaard: "#555555" (donkergrijs).
  • stroke-width / stroke-widthN (optioneel): Lijnbreedte (>=0). Standaard: 2.
  • stroke-opacity / stroke-opacityN (optioneel): Lijndoorzichtigheid/transparantie (0-1). Standaard: 1.0

Specifieke parameters: polygonen

  • fill / fillN (optioneel): Kleur van de polygoonvulling (behalve gaten). Standaard: "#555555" (donkergrijs).
  • fill-opacity / fill-opacityN (optioneel): Transparantie van de polygoonvulling (0-1). Standaard: 0.6.
  • stroke, stroke-width en stroke-opacity zijn ook van toepassing op de contourlijn.

Specifieke parameters: externe objecten

  • ids / idsN (optioneel): Identificatiecode van het element in Wikidata (Q...). Er kunnen meerdere identificatiecodes worden opgegeven, gescheiden door komma's. Standaard wordt de identificatiecode van de huidige pagina gebruikt. Geeft toegang tot OpenStreetMap-objecten die zijn gekoppeld aan de eigenschap wikidata=Q….
  • commons / commonsN (optioneel): Naam van een kaart op Wikimedia Commons, zonder het voorvoegsel "Data:" en met de extensie ".map". Voor voorbeelden, zie c:Special:Allpages/Data: en mw:Help:Map Data.