maplink

Liên kết bản đồLiên kết bản đồ

Khung bản đồ

maplink Tài liệu bản mẫu

This template adds a link, or frame, which will display map data – either from:

  • data stored in GeoJSON format on Wikipedia or Commons
  • line/polygon features in OpenStreetMap.
  • coordinates, either supplied or from Wikidata
  • raw GeoJSON, preferably transcluded from another page

Note:

  • If you have a very large/slow map, you should use the mapframe extension tag directly instead of this template, as was done in Special:Diff/970846012. The reason for this is that using the template to call the extension tag will result in the map rendering counting as Lua time, which may result in time exceeded errors.
  • GeoJSON files cannot currently be directly uploaded. Instead, on Commons, create a page that is in the Data: namespace and ends in .map – see mw:Help:Map Data for further information.
  • To make OpenStreetMap (OSM) features available, add the Wikidata key to the OSM relation (and wait 1 or 2 days) – see mw:Help:Extension:Kartographer#External_data and mw:Help:Extension:Kartographer/OSM for further information.

Cách sử dụng

This template is intended for points as well as linear or polygon features, including (but not limited to):

  • Roads
  • Rivers
  • Subway or train lines
  • Ship courses
  • Flight paths
  • Explorers journeys
  • Animal habitats
  • Countries and their subdivisions

and more... This template can also be used to display point features on a map, i.e. coordinates.

Ví dụ

Basic usage

  • on Commons (e.g. Data:ecos.fws.gov/Endangered habitat 58938/Plethodon neomexicanus.map):
      {{maplink|from=}} (specify .map data page in from=, excluding Data prefix)
  • : Không thể phân tích mã JSON: Lỗi cú pháp
    (e.g. {{Wikipedia:Map data/Main Roads Western Australia/Forrest Highway}}):
      {{maplink|raw=}} (specify raw GeoJSON, preferably transcluded from a subpage of Wikipedia:Map data)
  • : Nội dung JSON không phải là GeoJSON+simplestyle hợp lệ
    • /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"]
    from OSM:
      • {{maplink|type=line|id=}} (Wikidata id only required if another article's Wikidata page is to be used)
    • : Nội dung JSON không phải là GeoJSON+simplestyle hợp lệ
      • /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"]

      from OSM:

        • {{maplink|type=shape|id=}} (Wikidata id only required if another article's Wikidata page is to be used)
      • : Nội dung JSON không phải là GeoJSON+simplestyle hợp lệ
        • /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"]

        from OSM:

          • {{maplink|type=shape-inverse|id=}} (Wikidata id only required if another article's Wikidata page is to be used)
        • (coordinates):
            ...from Wikidata:
            {{maplink|type=point|id=}} (Wikidata id only required if another article's Wikidata page is to be used)
            ...from specified coordinates:
            {{maplink|type=point|coord=}} (specify coordinates using {{Coord}} template)
        • from a page or section ({{coord}} templates using the |name= parameter)
            ...from the current page: {{maplink|type=named}} or {{maplink|type=named|from=#Section}}
            ...from another page: {{maplink|type=named|from=Other page}} or {{maplink|type=named|from=Other page#Section}}
        • (centred on a point's coordinates):
            ...from Wikidata:
            {{maplink|type=circle|radius=|id=}} (Wikidata id only required if another article's Wikidata page is to be used)
            ...from specified coordinates:
            {{maplink|type=circle|radius=|coord=}} (specify coordinates using {{Coord}} template)
        • To show in a frame, add the parameter |frame=yes: {{maplink|frame=yes|frame-align=left|type=line|id=Q1094308|text=Mapframe example}}.
          Mapframe example
        • Additional parameters are available to customise the displayed map, such as |plain=yes to remove the outer frame: {{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}}.
          : Nội dung JSON không phải là GeoJSON+simplestyle hợp lệ
          • /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"]
          • Overlays can also be displayed on top of the map: {{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

          Parameter set – data page

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

          Parameter set – raw data

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

          Parameter set – geoline/geoshape

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

          Parameter set – point features/coordinates

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


          Parameter set – circles

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

          Ứng dụng

            display
            How the template is displayed. Valid values are:
              inline - Only displays the inline link (you can forego this, as it is the default)
              title - Only displays the title link
              inline,title - Displays the inline link as well as the title link
              title,inline - Same as above
            text
            Text to display for the link (or caption if using mapframe); default is "Map"
            icon
            Set to "no" to turn off the icon that appears next to the link
            zoom
            Zoom level, from 1 to 19 (larger numbers zoom in further); default is automatically determined by the map, unless the only feature is a single point.

          Mapframe parameters (only work with inline display)

            frame
            Set to "yes" to show a map frame instead of a link
              plain
              Set to "yes" to show just the map without the surrounding frame, and without a caption (text parameter will be ignored)
              frame-align
              Alignment with respect to the page: left, center, or right; default is right
              frame-width
              Width of the map frame, default is 300
              frame-height
              Height of the map frame, default is 200
              frame-coordinates
              (or frame-coord)
              Optional - alternate coordinates for initial placement of map. Use {{Coord}} template to specify coordinates (e.g. |frame-coordinates={{tl|Coord|12.34|S|56.78|W}}). If not set, coordinates will be retrieved from Wikidata.
              frame-latitude
              (or frame-lat)
              (ignored if |frame-coordinates= or |frame-coord= is set)
              Optional - alternate latitude coordinate for initial placement of map.
              frame-longitude
              (or frame-long)
              (ignored if |frame-coordinates= or |frame-coord= is set)
              Optional - alternate longitude coordinate for initial placement of map.
            maplink Ghi chú: If frame latitude and longitude are not set by parameters, then frame coordinates can be determined automatically, either:
            • Based on the line and shape objects (if any have been specified), or
            • From the point feature specified in |coord= (if set), or
            • Retrieved from Wikidata (if available – for either the item specified in |id= parameter, or for the page the template is placed on)
              overlay
              An image, or another map, to be displayed on top the map. E.g.
                |overlay=Bản mẫu:Elc or
                |overlay={{maplink|frame=yes|plain=yes|frame-width=100|frame-height=100|type=shape|id={{get QID|French submarine Ariane (1914)}}|frame-align=center}} or
                |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}}
                (see Template:Maplink/testcases/overlays to view examples)
                overlay-horizontal-alignment
                Horizontal alignment of overlay, either left or right; default is right
                overlay-vertical-alignment
                Vertical alignment of overlay, either top or bottom; default is bottom
                overlay-horizontal-offset and overlay-vertical-offset
                Optional – number of pixels to offset the overlay in from the edge of the map, e.g. 10 for a 10 pixel gap
                overlay-border
                CSS style for the border, e.g. 3px solid black; default is 1px solid white. The colour can be any web color name or hex code.
            raw
            Raw GeoJSON (preferably transcluded from a subpage of Wikipedia:Map data) as well as functionality not available via the other parameters. See below for more information.

          For each feature

          Multiple features can be displayed on a single map. For each additional feature, add a sequential number to the end of the parameter name. For example, the second uses parameters like |type2=, |id2=, etc., the third feature |type3=, |id3=, etc., and so on. Higher numbers are drawn on top.

            type
            Type of data. Valid values are:
              line – a geoline feature from OSM (e.g. a road)
              shape – a geoshape feature from OSM (e.g. a state or province)
              shape-inverse – a geomask feature from OSM (the inverse of a geoshape - allows an unobstructed view of the map beneath)
              data – a geoJSON data page on Commons (parameter is optional in this case)
              point – a point feature (coordinates)
              named – all named coordinates in an page or section ({{coord}} templates with |name= parameter)
              circle – a circle centred on a point's coordinates
            id
            (or ids)
            Wikidata id (Q-number) of the point feature, Wikidata id that the OSM line/shape feature is tagged with. Separate multiple ids with a comma. Defaults to the current page's Wikidata id (if |from= not set).
            from
            Source of map data:
            • If type is data or omitted: The JSON (.map) file from Commons to display (excluding the Data: prefix)
            • If type is named: Page name, or name#section, to get named coordinates from. If omitted, or specified as just #section, then current page will be used.
            title
            Title of the feature (for features from OSM), displayed when the feature is clicked on; default is the page title
            description
            Description of the feature (for features from OSM), displayed when the feature is clicked on; optional
            stroke-color
            (or stroke-colour)
            Color code for the color used to draw the feature (for features from OSM); default is #ff0000 (red)
            stroke-width
            Width for the lines used to draw the feature (for features from OSM); default is 6
            stroke-opacity
            Opacity for the lines used to draw the feature (for features from OSM) – a number between 0 (fully transparent) and 1 (fully opaque); default is 1
            fill
            Color code for the fill color of the feature (for shape or shape-inverse features from OSM); default is #000000 (black). Note that a semi-transparent version of the specified color will be used by default, allowing the map below to still be seen.
            fill-opacity
            Opacity for the fill color of the feature (for shape or shape-inverse features from OSM) – a number between 0 (fully transparent) and 1 (fully opaque); default is 0.5
            coord
            Coordinates to display for a point feature. Use {{Coord}} template to specify coordinates (e.g. |coord={{Coord|12.34|S|56.78|W}}). If not set, coordinates will be retrieved from Wikidata.
            marker
            Name of Maki marker image to display at the point feature. See mw:Maps/Icons for options. If not set, a plain marker will be shown without an image.
            marker-color
            (or marker-colour)
            Color code (Hex triplet) specifying marker background color. Default is 5E74F3 (    )
            marker-size
            Size of the marker. Can be small, medium (default) or large.
            radius
            (or radius_m), or alternative parameters radius_km, or radius_mi, or radius_ft
            Radius of the circle. In metres by default, or in kilometers or miles or feet if the alternative parameters are used.
            edges
            Number of edges used to construct the circle. Default is 32. Higher numbers will result in a smoother circle but use more Lua processing resources.

          TemplateData

          Adds a link, or frame, which will display map data

          Tham số bản mẫuQuản lý Dữ liệu bản mẫu

          Tham sốMiêu tảKiểuTrạng thái
          displaydisplay

          How the template is displayed

            Giá trị đề nghị
            inline title inline,title
            Mặc định
            inline
          Không rõtùy chọn
          texttext

          Text to display for the link (or caption if using mapframe)

            Mặc định
            Map
          Chuỗi ngắntùy chọn
          iconicon

          Set to "no" to turn off the icon that appears next to the link

            Luận lýtùy chọn
            zoomzoom

            Zoom level, from 1 to 19 (larger numbers zoom in further); default is automatically determined by the map, unless the only feature is a single point.

              Sốtùy chọn

              Multiple map switcher

              An option for Template:Switcher-style switching of multiple mapframes, where specified parameters like zoom, or frame coordinates, or a shape's item id are switched between different values. When using, ensure the number of values in each list are the same.

              Instructions:

              1. Add parameter switch to specify labels for the different options: a list separated by either,, or ; if the labels contain commas, or ### if the labels contain semi-colons. Each label will be displayed with a prefix of "Show ".
                  Example: |switch=zoomed out, zoomed mid, zoomed in
              2. For each parameter that is to be switched, set its value to SWITCH: followed by a list of values to switch between, again separated by , or ; or ###
                  Example: |zoom=SWITCH:4,9,14
                  Parameters frame, plain, and text should not be switched
              3. Make sure each list has the same number of entries. The position of value in a SWITCH: list corresponds to the same position in the list of labels set in |switch=.

              Example:

              {{mapframe|frame=yes|type=point|id={{Get QID|French submarine Ariane (1914)}}|text=Boston|zoom=SWITCH:4,9,14|switch=zoomed out, zoomed mid, zoomed in}}

              Tags:

              🔥 Trending searches on Wiki Tiếng Việt:

              Bộ Chính trị Ban Chấp hành Trung ương Đảng Cộng sản Việt NamLão HạcBộ Tổng tham mưu Quân đội nhân dân Việt NamBorussia DortmundBộ Tư lệnh Cảnh sát Cơ động (Việt Nam)Bộ Chính trị Đảng Cộng sản Trung QuốcThừa Thiên HuếHồn Trương Ba, da hàng thịtLý Thường KiệtBảy hoàng tử của Địa ngụcKim Ji-won (diễn viên)Cầu vồngTrần Quốc VượngThủ dâmNguyễn Minh Triết (sinh năm 1988)ĐứcVincent van GoghQuân chủng Hải quân, Quân đội nhân dân Việt NamTranh Đông HồPhó Chủ tịch Quốc hội Việt NamÔ nhiễm môi trườngHoa KỳMinh MạngHưng YênVũng TàuLê DuẩnNguyễn Văn NênIsraelXabi AlonsoLương Thế VinhTrung QuốcPhong trào Dân chủ Đông Dương (1936–1939)Quan VũSông Cửu LongTrương Tấn SangMông CổViệt Minh12BETGiải vô địch thế giới Liên Minh Huyền ThoạiDanh sách nhân vật trong One PieceTwitterDoraemonĐại ViệtTrần Đức ThắngHữu ThỉnhKiên GiangTôi thấy hoa vàng trên cỏ xanhLionel MessiNhà MinhBill GatesLê Thái TổMai vàngThái BìnhTử Cấm ThànhCúp bóng đá châu ÁMáy tínhCarlo AncelottiNguyễn TuânLê Thánh TôngLiếm âm hộGia LongNgân hàng Nhà nước Việt NamÔ ăn quanCực quangĐinh Tiến DũngThám tử lừng danh ConanLong AnBảng chữ cái tiếng AnhQuân hàm Quân đội nhân dân Việt NamUzbekistanVụ phát tán video Vàng AnhChùa Thiên MụKinh thành HuếChiến tranh cục bộ (Chiến tranh Việt Nam)Danh sách quốc gia theo dân sốCristiano Ronaldo🡆 More