View source for Help:Maps

Saintapedia editors/contributors can show geographic data on wiki pages with '''interactive maps.''' There are three services options, [[Google Maps]], [[OpenLayers]], and [[Leaflet]].  The later two pull their information from [[OpenStreetMap]].  Editors can create custom maps that display general areas, one location, multiple locations, linked pins, pop-up information windows, and many other search features.  

[[Enhanced editor]] must be used when adding or editing maps.  [[Saintapedia:Visual editor|VisualEditor]] does not allow you to make changes to maps.  

The default mapping method has been changed from Google Maps to OpenLayers due to a limit in Google Maps [[API]].  This functionality was added to Saintapedia through {{MW|Extension:Maps}}.

== Basic examples ==
Most editors will want to add only a single location to a map.  The easiest way to do this is with the street address of that location.  If you have the [[coordinates]] of the location, they can also be used.  

<pre>
{{#display_points:
1600 Pennsylvania Avenue NW, Washington, DC 20500
}}
</pre>

{{#display_points:
1600 Pennsylvania Avenue NW, Washington, DC 20500
}}

=== Specify size ===
Since the full width option will not be optimal for most Saintapedia articles, you could specify the width.  The example below is 500 pixels wide and 400 pixels tall.  

<pre>
{{#display_points:
1600 Pennsylvania Avenue NW, Washington, DC 20500
 |width=500|height=400
}}
</pre>

{{#display_points:
1600 Pennsylvania Avenue NW, Washington, DC 20500
 |width=500|height=400
}}

=== Right aligned table ===
Another cleaner, but slightly more complicated option is to put the map in a right aligned table.  This can be done in only a few steps by creating a [[template]] using the [[Boilerplate template]] call "[[Template:Map box|Map box]]."

See [[:Category:Map box templates]] for a full list of Map box templates.

==== Steps ====
# Come up with a name for the map, such as as "Los Alamos Field Office map"
# Add the name of the template to the page you want to display the map surrounded by curly brackets, such as adding <code><nowiki>{{White House map}}</nowiki></code> on [[White House]]
# Save the page
# Click on the name of your map (a [[red link]])
# Select "Map box" from the [[Boilerplate template]] drop down list
# Click on "Load"
# Add the title "Map of.."
# Replace "1600 Pennsylvania Avenue NW, Washington, DC 20500" with your location's mailing address or coordinates
# Save the page

Optional
# Add zoom by 
## Add a line under the address/coordinates line
## Add " <code>|zoom=7</code>" to that line
## Increase or decrease the zoom (1 = maximum zoom out, 20 = max zoom in) - See [[Help:Maps (Zoom)]] for examples
# "<code>~<nowiki>[[White House]]</nowiki></code>" can be removed or replaced by the name of the location
# "<code>~West Wing</code>" can be removed or replaced by a description of the location
# Customize the Edit link by changing the template name, in the line above after <code>fullurl:</code> to match the title of the new map template 
# Add [[Documentation]] by copying the three lines below to the bottom of the template.  When using the [[Boilerplate template]], you will be reminded to add the documentation by a 3rd line in the table.  Those templates created with this template that have not added documentation will be part of [[:Category:Map templates without documentation]].

== Map editor ==
[[File:Map Editor Screenshot.png|400px|thumbnail|right|Map Editor with labels]]
The Map editor, located at [[Special:MapEditor]], allows editors to create maps more easily than using the wiki text.

=== Map View Toggle ===
* Map - shows the map view of Google Maps
* Satellite - shows the map view of default mapping service embedded over satellite images of the location 

=== Action Menu ===
* Export to wiki code - Click on this menu item and copy its contents to add the map you created to the wiki
* Import from wiki code - Build on an existing map
* Edit map parameters - See [[#parameters]]
* Clear map - Start from the beginning with no data
* Add image overlay - Not working
 
=== Street View ===
{{W|Google Street View}} is a technology featured in Google Maps and Google Earth that provides panoramic views from positions along many streets in the world.

=== Zoom ===
* + zoom the map further in
* - zooms the map out

=== Data Entry Menu ===
{{multiple image
| align     = right
| direction = horizontal
| header    = Point data entry options

| image1    = Map point details screenshot.png
| alt1      = Colored dice with white background
| caption1  = Point options

| image2    = Map point details screenshot - add link.png
| alt2      = Colored dice with checkered background
| caption2  = Link options
}}
* Hand (default) - Allows you to move the map by clicking and dragging
* Point - Click on a location on the map to add a data point (see the options below)
** Popup with text 
*** Title
*** Text
*** Icon
*** Group
*** Inline label
*** Visited icon
** Link
*** Link
*** Icon
*** Group
*** Inline label
*** Visited icon
* Line
* Rectangle
* Circle
* Polygon
== Additional options ==
There are a number of [[Help:Maps (Parameters)|parameters]] that can be applied to Saintapedia's interactive maps.  Multiple images is the most popular.

=== Mapping services ===
[[OpenLayers]] is default there are two other possible [[Help:Maps (Services)|Mapping services]] ([[Google Maps]] and [[Leaflet]]).

=== Layers ===
These only works with [[Google Maps]].  <code>|service=googlemaps</code> needs to be added to any map 

* Traffic
** Added with <code>|layers=traffic</code>}
* Bike routes 
** Added with <code>|layers=bicycling</code>

=== Different mapping services ===
See [[Help:Maps (Open Layers examples)]] for Open Layers examples.

=== Basic map of DC ===
Maps allow just a city to be used.  See [[Help:Maps (City)]] for more details.

=== Basic map of DC, Open Layers ===
See [[Help:Maps (Open Layers examples)#Basic map of DC]]

=== With address ===
Maps allow street addresses to be used.  See [[Help:Maps (Address)]] for more details.

=== With address, open layers service ===
Moved to [[Help:Maps (Open Layers examples)#With address]]

=== Advanced ===
Maps also has built-in support for geocoding, displaying maps, displaying markers and geospatial shapes, adding pop-ups, and more and allows extensive customization per map, or for all maps on Saintapedia.  Documentation and examples for these options have not yet been created.

== Notes ==
* It seems as if a map fails to load, due to incorrect parameters, may prevent other maps further down the page from loading
* When listing multiple entries, you need to end each entry with an ";".  This ";"needs to be omitted from the last entry.
* You will not be able to preview a map.  It will say "Your browser is not compatible with Google Maps v3."  You need to save your changes before you can see their effects.

== Related ==
* [[Special:MapEditor]] - Creating maps made easy
* [[Help:Mapping services]]
* [[Help:Maps (Multiple locations)]]
* [[Help:Maps (Info boxes)]]
* [[Help:Maps (Centered)]]

=== Templates ===
* {{tlx|Map box}}

=== Examples ===
See
* [[:Category:Pages with maps]]
* [[:Category:Map box templates]]

== External links ==
Could be used to improve our documentation:
* http://mapping.referata.com/wiki/Display_points#Parameters
* http://edutechwiki.unige.ch/en/Maps_(MediaWiki_extension)#Displaying_Maps_V_3.x

=== External examples ===
* [https://www.semantic-mediawiki.org/wiki/Category:Maps_examples specific examples] (Semantic MediaWiki)
* [https://www.semantic-mediawiki.org/wiki/Category:Maps_examples#Google_Maps Google Maps links] (Semantic MediaWiki)

{{Purge}}

{{Map examples}}
[[Category:Help]]