编辑“Gallery:模块:地图（Map）”

{| border="1" cellspacing="0" cellpadding="5" align="center"
! ''此页提供Google地图与Gallery整合的相关信息。''
|}


'''进度跟进，Bug发布，特点请求以及捐赠'''在[http://sourceforge.net/projects/gmap-module Sourceforge项目页面]上<br>
有关该模块的'''疑难解答'''请见：[http://gallery.menalto.com/forum/75 第三方模块和外观主题的支持]<br>
'''模块用户'''[http://codex.gallery2.org/index.php/Gallery2:Modules:Map:UserGuide 指导在此]


'''历史：''' 
此最初为[http://gallery.menalto.com/user/66516 HorsePunchKid]所创建的模块<br>

开始都是由[http://gallery.menalto.com/user/32052 LarryDoliver]所创建的[[Gallery:Themes:Map |外观主题]]，稍后转为了模块。现在其具有诸多特点并且还有更多特点值得期待:-)，
这都要归功于 [[User:Termitenshort| Termite]]以及后文列出的开发者和测试者。
<br><br>

<div align="center" style="float: center; center: 10px; width: 200px; padding: 10px;   background-color: #ccffcc; border-color: black; border-style: solid; border-width: 1px; color:black;">
当前版本<br>
'''Gallery 2.0.x''' => [http://prdownloads.sourceforge.net/gmap-module/map-module-0.4.11d.zip?download 0.4.11d]  <br>
'''Gallery 2.1.x & 2.2.x '''  => [http://downloads.sourceforge.net/gmap-module/Map-Module-Version-0.5.6.zip 0.5.6]  <br>
''最近一次上传：2007-12-27''<br>
[[Gallery:Modules:Map:Changelog|参看Changelog]]<br>以及<br>
[[Gallery:Modules:Map:CurrentWork|我们的工作进度]]
</div><br>

==安装==
* 现在你可以通过可下载的插件进行安装：[[Gallery:How_to_Install_Plugins |如何安装插件]]

==举例==
===截屏===
*[[:Image:MapTeamPic.gif|Map模块截屏]]
*[[:Image:MapTheme.jpg|Map外观主题截屏]]
*[[Gallery:Modules:Map:Screenshots |更多截屏图]]

===在线实时地图===
*[http://www.claessen.ca/photos?g2_view=map.ShowMap&g2_filter=All claessen.ca: Guido's Website - Photo Map （使用WPG2 3.0）]
*[http://tautologous.com/gallery2/travel/ Theme @ tautologous.com]
*[http://severinghaus.org/gallery/map/ HorsePunchKid's photo map]
*[http://vinlai.com/blog/map/ Vincent Lai's Travel Photos map]
*[http://gallery2.ca/photos?g2_view=map.ShowMap Floridave's Photo Map]
*[http://www.jontodd.com/wp-gallery2.php?g2_view=map.ShowMap&g2_Mode=Normal&g2_Group=&g2_album=Acadia+2006 Jon Todd's Acadia Photo Map]
*[http://www.gran-canaria-info.com/photos/main.php?g2_view=map.ShowMap Gran Canaria (Canary Islands) Map] (criticism welcome!)
*[http://www.goldcoastinfo.net/photos/main.php?g2_view=map.ShowMap&g2_Mode=Normal&g2_Group=&g2_album=Gold+Coast+Photos Gold Coast Australia - Photo Map]

==下载==
* '''Gallery 2.0.x'''的Google地图模块：[http://prdownloads.sourceforge.net/gmap-module/map-module-0.4.11d.zip?download 下载]
* '''Gallery 2.1.x'''的Google地图模块：[http://downloads.sourceforge.net/gmap-module/Map-Module-Version-0.5.6.zip 下载] （也可通过Gallery 2.2+ 的[[Gallery:Downloadable Plugins|可下载插件]]）
* '''Gallery 2.0.x'''的Google地图外观主题：[http://prdownloads.sourceforge.net/gmap-module/map-theme-1.0.4a.zip?download 下载（v1.0.4a）]
* '''Gallery 2.1'''的Google地图外观主题：[http://prdownloads.sourceforge.net/gmap-module/mapTheme_1.0.5.zip?download 下载（v1.0.5）]
* '''Gallery 2.1和Google Maps API-V2'''的Google地图外观主题：[http://prdownloads.sourceforge.net/gmap-module/mapTheme_1.0.7.zip?download 下载（v1.0.7）]

* Google地图模块图标：[http://codex.gallery2.org/images/d/dd/GoogleIcon.zip 下载]
* 你也可通过[http://sourceforge.net/svn/?group_id=152389 SVN]下载最新的修订版模块
* 浏览最新的源代码：[http://gmap-module.svn.sourceforge.net/viewvc/gmap-module/Gallery2.1/modules/ gmap-module]

==通过SVN下载==
在Windows客户端上安装一个SVN客户端。我使用的是：
http://tortoisesvn.net/downloads

接着添加：
https://gmap-module.svn.sourceforge.net/svnroot/gmap-module/Gallery2.1/modules/map
这是存储库的URL地址。

浏览SVN中的修改：http://gmap-module.svn.sourceforge.net/viewvc/gmap-module/Gallery2.1/modules/?sortby=date

==重要==
*'''你无需同时具有模块和外观主题'''，参见 [[#模块与外观主题之间的不同之处|后文]]来看看两者到底有何不同<br>
*该模块有两个版本分别对应gallery2.0及较低版本和gallery2.1及较高版本，它们是不可交互兼容的。

== 要求 ==
'''对于二者'''
* Gallery 2 – 带有一些相册和相片，否则的话它不会太有用处:)
* [http://www.google.com/apis/maps/signup.html 此为]需要的Google API Key 
'''仅对模块而言'''
* [http://www.imagemagick.org ImageMagick]（你可以不用它但少享受一些特点）
* Gallery EXIF- 1.0.1及更高版本模块也可与1.0.0兼容，只需做很少的[http://codex.gallery2.org/index.php/Gallery2:Download#Modules 修改]
'''仅对外观主题而言'''
* 自定义字段（Custom Fields）模块在 [http://codex.gallery2.org/index.php/Gallery2:Download#Modules 此]

== 指导 ==

有关外观主题更详尽的指导请见：[[Gallery:Themes:Map]]

有关模块更详尽的指导请见：[[Gallery:Modules:Map:UserGuide]]（开发中）

==模块与外观主题之间的不同之处 ==
'''注：''' <br>''目前的模板针对gallery2.1进行了测试，将会含有外观主题的大多数特点，这将使得外观主题在一定程度上显得落后了''<br><br>
[[image:MapTheme.jpg|thumb|Map外观主题相片]]
; 外观主题以相册为基础
* 基本安装了外观主题后就可将其应用于某相册了
* 外观主题是基于原始的Matrix外观主题之上的
* 该相册会在使用API的Google地图上显示所有相片和相册，而GPS坐标则包含在了相册中。
* 它使用某种API key，该key需要按单位相册进行输入（如果你为自己的domain使用key的话，它们可以是相同的）
* 具有该外观主题的各相册更像这样 =>
* 具有该外观主题的各相册可进行特定的设定
* 你需要安装Custom Fields模块来输入坐标


[[image:TheMap.jpeg|thumb|[[Gallery:Modules:Map:Screenshots|更多截图]]]]
; 模块的工作方式不同并具有更多的特点。
* 它具有全局参量，并且来自整个gallery的带有GPS坐标的相册和照片被显示在单张Google地图上
* 有不少人正在为该模块进行工作，你可以在此wiki页面上查看有关该模块的更新
* 在主要的特点之中，有一特点是能够从地址，EXIF信息以及"point/click"处手机GPS坐标
* 还可以创建你自己的markerset以及联系marker的路线（route）
* 该模块的特色集将会不断得到扩充 :-) 参见[[#模块目前的特点集|后文]]来看看目前的特点集。
* 如果你希望查看该模块的截图，可以在[[Gallery:Modules:Map:Screenshots |此]]找到
* 详尽且不断更新的特点列表请见后文

==模块目前的特点集 ==

各相册/相片的特殊地图设定，这将会以弹出方式显示在Google地图上，并且带有缩略图和链接
*   按以下所列输入数据
**  手动地在google地图上
*** 自各点
*** 和某地址输入
*** GPS坐标
<br>
*   模块重写支持（创建规则使/map/指向地图）
<br>
*   调整地图尺寸（%或像素），默认缩放级别，地图中心点
**  放大机缩小链接的缩放级别（Zoomlevel）
**  自动化Center&Zoom 
<br>
*   可新建或上传Marker或MarkerSet
**  basemarker的选择
**  尺寸的选择Choice of size
**  颜色的选择（所有或一些）
**  相册和图标的不同marker集。
<br>
*   [http://www.googlemappers.com/libraries/gxmagnifier/docs/default.htm GxMagnifier]
**  在地图上能有2个放大镜
**  （通过放大镜图标）进行常规缩放（Zoom）
**  显示一不同的缩放（如negative zoom）
**  GxMagnifier对点击有反应
<br>
*   修改缩放控制（Zoom Control） 
**  内置外观主题
**  可创建自己的
<br>
*   线路（链接相册/相片的polyline）
**  能够在某路线中重复使用某项目
**  某路线的marker部分按照所选定的排序进行编号
<br>
*   显示地图某特定区域的过滤器
**  可指向某路线的过滤器
**  可显示仅为与相册和子相册中项目的过滤器
<br>
*   模块页面上显示的legend
**  通过点击图例显示/隐藏地图上特定颜色的标记
**  图例可为边栏上的一个区块
<br>
*   可以创建"Google Map Group"
**  一个组（group）就是一个marker（缩略图，GPS坐标，放大等级，颜色，描述等等）
**  一个组可以含有相片，相册和小组
**  当点击一个组时，仅在地图上显示属于该组的部分
**  组可以使用自己的MarkerSet
<br>
*   自外观主题（gallery2.1版本）添加缩略图条
**  可被定位在地图周围
**  根据需要字段添加滚动条
**  点击1个项目会定向到该项目并打开其窗口
**  鼠标悬停效果
<br>
*   向Google Earth导出数据
**   能够启用/禁用"导出至GE"
<br>
*   信息窗（Infowindows）
**  自定义外观
**  与缩略图一起插入自定义链接和元数据
<br>
*   多语言支持
*   Google地图key管理（Google Map Key Management）特点（根据站点访问方式的不同有多种key）
*   自动由EXIF头填入GRP坐标
*   显示浏览历史并允许"还原"

== 变通方法 ==
*''点击某项目不显示infowindow'''：在Map地图当前的两个版本中，由于Google 地图API的某些改动导致GxMagnifier扩展不再可用，因为这些改动阻止Infowindw的打开。
变通方法：
禁用GxMagnifier扩展。首先确保在general标签中'''已启用了'''GxMagnifier特点，接着打开GxMagnifier标签并在此禁用该特点。完成之后，你可在general标签上禁用"该特点"，这将会移除该标签。该模块的下个版本会包含进GZoom，也就不会有这种问题了 :-)

*'''与PG外观主题并用的模块：''' Map模块的0.4.8d版本包含模块方所需做的修改。而外观主题也需要进行修改：

在'''Theme.js'''中找到该行（靠近文件尾）
<pre>
var browser = new Browser();
</pre>
将其改为
<pre>
if (undefined === window.GoogleMap) {var browser = new Browser();}
</pre>

* '''IE中的route''' 当启用某route，IE会显示JavaScript错误。
你需要编辑'''theme.tpl'''（我建议创建一个"local"文件夹并将你修改好的tpl文件放在其中

在新文件中，你需要将<html>标记改为如下的样子：
<pre>
<html xmlns="http://www.w3.org/1999/xhtml" xmlns:v="urn:schemas-microsoft-com:vml">
</pre>
'''自0.4.10版本开始，可以通过一个按钮进行此修改。
'''

== Gallery2:Map模块团队==
<div align="center" style="position: absolute; right: 10px; width: 200px; padding: 10px;   background-color: #FFCC99; border-color: black; border-style: solid; border-width: 1px; color:black;">
[http://termite.responsiveweb.com/MapModuleTeam/ <font size="5">'''ADD YOURSELF'''</font>]
----
[[Image:MapTeamPic.gif|thumb|[http://termite.responsiveweb.com/MapModuleTeam/Map/ See the real thing !]]]<br>

</div>
===开发者===
; 原班人马：
* [http://gallery.menalto.com/user/32052 LarryDoliver]创建了[[#模块与外观主题之间的不同之处|外观主题]]。
* [http://gallery.menalto.com/user/66516 HorsePunchKid]则将其转为了地图模块的第一个版本。

; 后继有人：
* [[User:Termitenshort| Termite]]：领头羊
* [[User:Floridave| Floridave]]：殚精竭虑中。
* [[User:Jelwell | Jelwell]]
* [[User:jcampbell1 | jcampbell1]]：更多问题的修复就靠这位了。
* [[User:Ninjainvasion | Ninjainvasion]]：正尽力完善此模块。
* [[User:SiliconFiend | SiliconFiend]]："向Google Earth导出"特点的重写，迷你地图区块，bug修复以及其他改良
* 很多其他开发者的wiki名称尚不知晓…如悉的话请在此更新上来

===测试者===
*[[User:igrcic|Igrcic]]：测试无止境:) 
*#g2使用PostgreSQL db安装在linux slackware box上的。 
*#现在使用带有MySql的Win2k,IIS/5 :(
Testing it on 在WinXP和slack上使用最新的Mozilla和Firefox浏览器对其进行了测试。
*[[User:swordfish|Swordfish]]：''' 嵌入[http://wpg2.ozgreg.com/index.php/Main_Page WPG2]中的'''测试。使用Apache1, PHP-4.4.0, mod_gzip, MySQL 4.0.25在Gentoo linux 上安装G2/WordPress。在3台独立的WinXP 机器上使用IE6和火狐浏览器进行测试。
*[[User:billimemk|Jeff Billimek]]：早期作出了一些贡献，目前正进行模块的测试。
*[[User:galmoid|Galmoid]]
*[[User:dotnature|dotnature]]：尝试更新wiki，图标并且在joomla中进行测试。
*[[User:caddymob|caddymob]]：早期测试者，很快地添加了大量geotagged相片...
*[[User:christ|christ]]：由Gallery 2.1入伙：正广泛地使用它
*很多其他测试者的wiki名称尚不知晓…如悉的话请在此更新上来

== 测试于 ==
'''服务器端'''<br/>
Linux Server（fedora core 3和4）<br/>
Windows XP SP2<br/>
SunOS u30 5.9<br/>
Debian Sarge, Ubuntu 5.10<br/>
SME Server 7.x（基于Centos 4）<br/>
Apache 1.3.33，PHP 4.3.10, MySql 4.1.9<br/>
Apache 2.0，PHP 5.0，Mysql 4.1.9<br/>
Apache 2.0.49 PHP 4.3.4 Mysql 4.0.18<br/>
Apache 2.0.53，PHP 4.3.11，Mysql 4.1.12<br/>
Apache 1.3.33，PHP 4.3.10，Zend 1.3.0，Mysql 4.1.11<br/>

'''客户端'''<br>
Windows XP SP2上的Internet explorer 6.0 SP2 <br>
Windows XP SP2上的Internet explorer 7.0 <br>
Windows XP上的Deer Park Alpha 2 <br>
Windows Vista Home Premium 上的Firefox 2.0.0.6 <br>
Windows XP上的Firefox 1.5 beta 2 <br>
Windows XP SP2上的Firefox 1.5.0.1（最终版）<br>
Fedora Core 3上的Firefox 1.0.7<br>
MAC OS X 10.4.2上的Safari<br>
MAC OS X 10.4.4, 10.4.5和10.4.6上的Safari 2，Camino 1.0以及Firefox 1.5.0.1<br>
<br>

[[Category:Gallery 2:Contributed modules|Map]]
[[Category:Gallery 2:Modules|Map]]