‎<mapframe>

mapframe width=400 height=400 zoom=15 longitude=13.377704 latitude=52.516275

要在wiki頁面上的小視窗（或框架）中添加一個地圖，請使用標籤‎<mapframe>。點擊小地圖會開啟一個全螢幕的互動地圖。

• 在維基百科和其他維基媒體的維基上，內嵌的地圖是靜態的。點選靜態圖片會開啟全螢幕的互動地圖。
• 在維基導遊和test2wiki上，此內嵌地圖是互動式的。點選、按住並移動游標可以平移地圖；雙擊或點選頂部角落的全螢幕圖示可以開啟全螢幕互動地圖。

在最簡單的表單中，‎<mapframe>使用下列資訊來顯示特定區域的地圖：

• 位置 (經度與緯度)
• 框架的大小（寬度和高度）

示例： <mapframe width=400 height=400 zoom=15 longitude=13.377704 latitude=52.516275 />

For a complete explanation of the syntax as well as a list of available attributes, see the main help page.

‎<maplink>

示例： <maplink text="Downtown San Francisco" longitude=-122.3988 latitude=37.8013 />

Downtown San Francisco

For a complete explanation of the syntax as well as a list of available attributes, see the main help page.

Composing GeoJSON

What follows is a brief overview of commonly used powerful GeoJSON elements. For more in-depth coverage of the topic, see Help:Extension:Kartographer#GeoJSON and our full list of GeoJSON resources.

Markers

To place a marker on your map, use the GeoJSON object "Feature". You can choose the marker's exact location on the map, the symbol used, its color and size, a title, a descriptive image, and more -- including whether to use letters or numbers across multiple markers.

Colorado State Capitol

<mapframe text="Colorado State Capitol" longitude="-104.98491" latitude="39.73939" zoom="17" width="250", height="250">
{  "type": "Feature",
   "properties": 
       { "marker-symbol": "town-hall", 
         "marker-color": "46ea5f", 
         "marker-size": "medium", 
         "title": "[[w:Colorado_State_Capitol|CO Capitol]]", 
         "description": "[[File:Coloradocapitolhill2.JPG|150px]]"
       },
    "geometry": 
       { "type": "Point", 
       "coordinates": [-104.98485267162323, 39.73928364167763] 
       }
}
</mapframe>

Shapes

GeoJSON allows you to draw shapes on top of a map. You can define simple shapes inline or import shape data from places like Wikidata and OpenStreetMap.

Though we include some illustrative examples below, much of this work is most easily done in a GeoJSON editor. If your wiki has VisualEditor enabled, refer to our guide to using VisualEditor to create maps or use this editor.

Inline

Using GeoJSON, Kartographer lets you define points (markers), lines and polygons to be drawn over your defined map area using special syntax and longitude/latitude coordinates.

<mapframe latitude="46.528635" longitude="-122.299805" zoom="6" width="246" height="272" align="right">
    {
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "geometry": {
        "type": "LineString",
        "coordinates": [
          [-122.321777, 47.598526],
          [-122.629395, 45.505662]
        ]
}}]} 
</mapframe>

For more information, consult the Inline section of the main help page.

External data

In addition to displaying and marking up maps, Kartographer can also draw on the vast resources of geodata that Wikidata and OpenStreetMap have to offer. That data can help you highlight areas of your map using geoshapes, geographical data that describes the physical properties of an area.

• "service": "geopoint": Draws a marker.
• "service": "geoline": Draws a simple line.
• "service": "geoshape": Draws a polygon with a shaded interior.
• "service": "geomask": Draws a polygon and shades everything outside the polygon.

A geoshape of Madagascar

A simple example:

<mapframe text="Madagascar" width=300 height=300 zoom=4 longitude=46.523 latitude=-19.86>
{
  "type": "ExternalData",
  "service": "geoshape",
  "ids": "Q1019"
}
</mapframe>

In addition to placing a single geoshape on your map, you can also use SPARQL queries to bring in several related geoshapes from Wikidata. (For help writing SPARQL, take a look at Wikidata's Query Builder.)