README

某些Google API的接口

此包包含

• maps.js：一个助手类nettools.google.maps.MapManager，用于提供显示地图、路线和标记的有用方法。

安装说明

要安装 net-tools/google-js-api 包，只需通过 composer 需求它，并在 HEAD 部分插入所需的任何脚本标签（将 file.js 替换为上述任何包）

<script src="/path_to_vendor/net-tools/google-js-api/src/api/file.js"></script>

参考

nettools.google.maps.MapManager 类

MapManager 类可以使以更简单的方式显示地图、路线和标记。例如，任何创建的标记都将存储在 MapManager 类中，这样就可以稍后通过调用 raz() 方法从地图中删除它们。

首先，创建一个 nettools.google.maps.MapManager 类的对象；必需的构造函数参数是

• mapdiv：显示地图的 DOM 元素的 ID 或 DOM 节点
• centerpoint：一个 google.maps.LatLng 对象或一个具有所需默认显示坐标的文对象 {lat:value, lng:value}
• mapOpt：一个文对象，包含 google.maps.Map 可用的任何选项（如 mapTypeId）
• directionsRendererOpt：一个文对象，包含 google.maps.DirectionsRenderer 可用的任何选项

var mm = new nettools.google.maps.MapManager(
          // mapdiv
          "map_canvas2",
          
          // centerpoint
          {lat:45.763691, lng:3.119431}, 
          
          // mapOpt : options for google.maps.Map
          {
              // default zoom
              zoom: 2,

              // streetview widget off
              streetViewControl : false
          }
      );

MapManager 类提供以下成员

• map：访问底层 google.maps.Map 对象的属性
• raz()：清除地图的方法；它删除标记、路线并重置默认选项（如中心点）
• getDirectionsRenderer()：获取 google.maps.DirectionsRenderer 对象的方法；用于获取计算出的路线的信息
• getDirectionsService()：获取 google.maps.DirectionsService 对象的方法
• getInfoWindow()：获取 google.maps.InfoWindow 对象的方法（每个地图一个），
• createMarkers(Object[])：一次创建多个标记的方法；预期参数是描述标记的文对象数组（通常 {position:{lat:xxx, lng:xxx}, map:mm.map, title:'Marker here!'}）
• createMarker(Object)：创建单个标记的方法；标记参数在预期的文对象中设置
• route(point1, point2, options, callback_ok, callback_ko)：计算并显示两点之间路线的方法。参数是
  • 前两个参数设置起点和终点坐标（预期类型可以是字符串、google.maps.LatLng 对象、文对象 {lat, lng} 或 google.maps.Place 对象）
  • 一个文对象选项，用于向 DirectionsService 类提供参数（如 directionsTravelMode 等）
  • 成功结果或失败的回调（请参阅示例文件以获取详细信息）