Google Maps Extensions/GMap/Docs

GISWiki - Das freie Portal für Geoinformatik (GIS)
Wechseln zu: Navigation, Suche

from http://www.schwen.de/wiki/GMap


see also:


Installation

1. Unzip

Unzip the archive into your extensions directory and add
include("extensions/gmaps/gmaps.php");
to your LocalSettings.php.

2. Get Map-Key

Apply for a Google Maps site key here. Insert this key into gmaps/gmaps.php on line 37
$gmapKey='<your key>';

3. Cosmetics

For better compatibility with IE check your skins directory and insert
xmlns:v="urn:schemas-microsoft-com:vml"
into all <html> tags in the skin-files. Mine looks like this now (MonoBook.php line 54 excerpt):
<html xmlns="http://www.w3.org/1999/xhtml" xmlns:v="urn:schemas-microsoft-com:vml" xml:lang="<?php $this->text('lang') ?>" lang=.....

Usage

lets start with the most complicated example

<gmap lat="40.748" long="-73.886" zoom="5" helper="line" width="500" height="400" precision="5" type="satellite"> points: 40.763905|-73.826374|Flushing YMCA. website 40.75974059207392|-73.82898330688477|Main Street station (7 line)

lines: ff0000|3|0.5|40.759741|-73.828983|40.759220|-73.831043|40.758635|-73.832674|40.758180|-73.834305|40.757855|-73.836021|40.757335|-73.837652|40.755742|-73.841643|40.753726|-73.848510|40.750931|-73.857822|40.750085|-73.860569|40.749533|-73.865504|40.748948|-73.870826|40.748232|-73.877950|40.747582|-73.884215|40.746314|-73.896103|40.745501|-73.903527|40.745306|-73.905587|40.745306|-73.906960|40.745176|-73.908162|40.744721|-73.910480|40.742998|-73.916187|40.742900|-73.916702|40.742900|-73.917431|40.743583|-73.923376|40.744672|-73.932538|40.744770|-73.933139|40.745322|-73.933868|40.749110|-73.937838|40.749338|-73.938096|40.749663|-73.938525 </gmap>

Note how you can append new coordinates to the textarea above by clicking on the map.

Here comes the code:

<gmap lat="40.748" long="-73.886" zoom="5" helper="line" width="500" height="400" precision="5" type="satellite">
points:
40.763905|-73.826374|Flushing YMCA. [http://www.ymcanyc.org/sub.php?p=services&sp=guest/guestbrookqueens website]
40.75974059207392|-73.82898330688477|Main Street station (7 line)

lines:
ff0000|3|0.5|40.759741|-73.828983|40.759220|-73.831043|40.758635|-73.832674|40.758180|-73.834305|40.757855|-73.836021|40.757335|-73.837652|40.755742|-73.841643|40.753726|-73.848510|40.750931|-73.857822|40.750085|-73.860569|40.749533|-73.865504|40.748948|-73.870826|40.748232|-73.877950|40.747582|-73.884215|40.746314|-73.896103|40.745501|-73.903527|40.745306|-73.905587|40.745306|-73.906960|40.745176|-73.908162|40.744721|-73.910480|40.742998|-73.916187|40.742900|-73.916702|40.742900|-73.917431|40.743583|-73.923376|40.744672|-73.932538|40.744770|-73.933139|40.745322|-73.933868|40.749110|-73.937838|40.749338|-73.938096|40.749663|-73.938525
</gmap>

Arguments

Arguments are the name="value" pairs in the opening <gmap ...> tag.

Argument Description
lat,long Latitude, Lonitude in degrees
zoom Zoom factor, (-1 beeing max. and 20 min. zoom)
width,height Dimensions of the map window in pixels
helper Toggles the display of the helper box below the map, used to digitize coordinates. Two modes available helper="on" for simple mode outputting current map view settings, helper="line" to create a sequence of coordinates on click (used in the above example).
precision Sets number of decimal digits used in the helper widgets. Six are usually enough (last digit represents about one pixel at the highest zoom level). If you do not have enough significant digits this can cause the map to not generate.
type Chooses map type. Available are type="map" (default),type="satellite", and type="hybrid".

In between the tags

The code in between the gmap tags is used to create points (markers) and lines

Point syntax

points:
lat|long|wiki text for the first point
lat|long|wiki text for the second point
...

A set of points commences with a single line containing only the command points:. Next are lines (one for each point) with latitude and longitude in degrees and a piece of wikitext (may contain images etc.). The wiki text will become visible in a bubble above the point, it it is clicked on.

Line syntax

lines:
color|width|opacity|lat1|long1|lat2|long2|lat3|long3|....
color|width|opacity|lat1|long1|lat2|long2|lat3|long3|....
...

A set of lines commences with a single line containing only the command lines:. Next are lines (one for each line), color being the color of the line (6 character hex, i.e. ffaa77), width an integer setting the width of the line, and opacity a float from 0 (fully transparent) to 1 (completely visible), then an arbitrary number of latitude longitude pairs.