- 整体框架概述
- 快速入门
- 进阶教程
- API类参考
- 搜索接口
- 导航接口
- 公交接口
|
 |
搜索接口（Search API）介绍:
搜索接口（Search API）是我要地图网新推出的接口，利用该接口，您就可以轻松的实现本地搜索功能。
例如：搜索北京市易图通科技(北京)有限公司位置坐标，搜索易图通公司附近的饭店位置坐标。通过调用Search API服务，您就可以进一步扩展您的地图接口，开发出更加精彩的应用服务。
 本地搜索接口显示效果
|
|
以下是本地搜索接口代码,用户把下面代码复制，在各自使用的工具里新建文件后直接贴上去即可 |
|
导航接口（Navigate API）介绍:
利用驾驶导航接口，可以方便的计算出起点和终点之间导航的路程，可以获取导航路程上的相关细节信息。通过设置一个起点和一个终点，并传递相关的经纬度可以得到导航的结果，结合Search API可以更好地得到起点和终点的相关信息。
驾车导航接口显示效果
| |
以下是导航接口代码,用户把下面代码复制，在各自使用的工具里新建文件后直接贴上去即可 |
|
公交接口（Search API）介绍:
公交查询接口（Bus API）是我要地图网新推出的接口，利用该接口，您就可以轻松的实现本地搜索功能。
例如：搜索北京市易图通科技(北京)有限公司位置坐标，搜索易图通公司附近的饭店位置坐标。通过调用Search API服务，您就可以进一步扩
展您的地图接口，开发出更加精彩的应用服务。
公交查询接口显示效果图
|
以下是公交搜索接口代码,用户把下面代码复制，在各自使用的工具里新建文件后直接贴上去即可 |
|
|
线路查询接口显示效果图
|
以下是线路查询接口代码,用户把下面代码复制，在各自使用的工具里新建文件后直接贴上去即可 |
|
站点查询接口显示效果图
|
以下是站点查询接口代码,用户把下面代码复制，在各自使用的工具里新建文件后直接贴上去即可 |
|
如果您想要在地图上显示您的内容，则需要了解以下类、类型和函数：
EMaps 类
对类 EMaps 实例化以创建地图。这是 API 中的中心类。其他的都是辅助类。
构造方法返回顶部 |
| 构造方法 |
参数 |
说明 |
| EMaps(containerId) |
containerId: Object 或 String 类型，用来显示地图的层或层的ID，必须是已经在页面文档之中存在的层。 |
EMaps API的核心对象，在装载地图组件中创建一个EMaps对象，显示地图。 |
属性 |
| 方法 |
类型 |
说明 |
| height |
Integer |
地图高度。 |
| width |
Integer |
地图宽度。 |
方法 |
| 方法 |
返回类型 |
参数 |
说明 |
| addOverlay(overlay) |
无 |
overlay: 叠加层类型的对象实例，比如EMarker，EPolyline等。 |
将叠加层添加到地图中。 |
| centerAndZoom( centerPoint, zoomLevel) |
无 |
centerPoint: EPoint 类型，表示中心点对象。
zoomLevel: Integer 类型，表示地图缩放级别。有效值范围：0 - 12。 |
初始化或重新定位地图的中心点和缩放等级，在运行该方法之前不能执行添加标注等操作。 |
| clearOverlays() |
无 |
无 |
移除地图上的所有叠加层。 |
| clearMarkers() |
无 |
无 |
移除地图上的所有EMarker叠加层。 |
| clearPolylines() |
无 |
无 |
移除地图上的所有内部不填充的折线叠加层。 |
| clearPolygons() |
无 |
无 |
移除地图上的所有内部填充的折线叠加层。 |
| getOverlayById(id) |
overlay对象。 |
无 |
按id返回叠加层对象。 |
| getCenter() |
EPoint 类型，包含中心点经纬度信息的点对象。 |
无 |
获取地图中心点对应的地理坐标。 |
| getContextMenu() |
EContextMenu 类型。 |
无 |
获取与地图相关联的弹出菜单对象。 |
| getZoomLevel() |
Integer 类型。 |
无 |
获取地图当前的缩放级别（范围为0-12） |
| hideBubble() |
无 |
无 |
关闭当前打开的信息浮窗。 |
| panTo(x, y) |
无 |
x: Integer 类型，表示横向移动 x 个像素。
y: Integer 类型，表示纵向移动 y 个像素。 |
以动画效果移动地图的中心点。 |
| refresh() |
无 |
无 |
刷新地图以反应最新的地图状态。 |
| removeContextMenu() |
无 |
无 |
删除与地图相关联的右键菜单对象 |
| removeOverlay(overlay) |
无 |
overlay: 需要移除的叠加层类型的对象实例或者此对象的id。 |
从地图中移除叠加层。 |
| resize(width, height) |
无 |
width: Integer 类型，新的地图宽度，单位：像素。
height: Integer 类型，新的地图高度，单位：像素。 |
重新设定地图的宽度和高度。 |
| setSuitZoom(pts) |
无 |
pts: Array 类型，需要进行适应的 EPoint 对象集合。 |
根据传入EPoint集合的位置自动获取合适的比例尺和中心点。 |
| setCenter(centerPoint) |
无 |
centerPoint: EPoint 类型，表示中心点对象。 |
将地图的中心点变换到指定的地理坐标。 |
| setStandardContextMenu(menu) |
无 |
menu: EContextMenu 类型，弹出菜单对象。 |
设置与地图相关联的弹出菜单对象。 |
| setCursorIcon(iconUrl) |
无 |
iconUrl: String 类型，图标文件的 url 。 |
在标注模式下，设置与鼠标指针联动的图标图像。 |
| setMode(strMode, callbackFunction) |
无 |
strMode: String 类型，表示地图操作模式的字符串常量。 |
设置地图操作模式，以及事件处理程序。 |
| setZoomLevel(level) |
无 |
level: Integer 类型，指定的缩放级别，有效值范围：0 - 12 。 |
将视图切换到指定的缩放等级,中心点坐标不变。 |
| showControl(visible) |
无 |
visible: Boolean 类型，true 为可见，false 为不可见 。 |
设置平移/缩放控件的可见性。 |
| showOverview(visible, state) |
无 |
visible: Boolean 类型，true 表示显示缩略图控件，false 表示不显示。
state: Boolean 类型，true 表示最大化缩略图控件，false 表示最小化。 |
控制缩略图控件的显示状态，以及最小化/大化控件。 |
| showScale(visible) |
无 |
visible: Boolean 类型，true 为可见，false 为不可见 |
设置比例尺控件的可见性。 |
| zoomIn() |
无 |
无 |
地图放大一级视图。 |
| zoomOut() |
无 |
无 |
地图缩小一级视图。 |
EBrush 类
对类 EBrush 实例化以创建绘制折线的画笔对象。画笔包含了所绘制折线的所有样式信息。此类的实例用于 EPolyline 的构造函数中。
构造方法返回顶部 |
| 构造方法 |
参数 |
说明 |
| EBrush() |
无 |
创建 EBrush 对象。 |
属性 |
| 方法 |
类型 |
说明 |
| arrow |
Boolean |
是否在折线的终点显示箭头。 |
| bgcolor |
String |
当 fill 属性为 true 时，获取或设置填充颜色。颜色可以是十六进制数字 HTML 样式或颜色名称，例如，使用 #ff0000 和 red 都可以。 |
| bgtransparency |
Integer |
当 fill 属性为 true 时，获取或设置填充透明度，值越大透明度越低。 |
| color |
String |
折线的颜色。颜色可以是十六进制数字 HTML 样式或颜色名称，例如，使用 #ff0000 和 red 都可以。 |
| fill |
Boolean |
是否填充折线区域。 |
| stroke |
Integer |
折线的粗细，单位：像素。 |
| style |
Integer |
折线样式，有效值为 0 和 1， 0 表示实线， 1 表示虚线。 |
| transparency |
Integer |
折线的透明度，值越大透明度越低。 |
对类 EContextMenu 实例化以创建地图或叠加层弹出菜单对象，它包含了若干菜单项（EContextMenuItem）对象。此类的实例用于 EMaps 对象和叠加层对象的 setStandardContextMenu() 的方法中。
构造方法返回顶部 |
| 构造方法 |
参数 |
说明 |
| EContextMenu() |
无 |
创建 EContextMenu 对象。 |
属性 |
| 方法 |
类型 |
说明 |
| items |
Array |
获取菜单项对象集合。 |
方法 |
| 方法 |
返回类型 |
参数 |
说明 |
| addItem(menuItem) |
无 |
menuItem: EContextMenuItem 类型，菜单项对象。 |
增加菜单项。 |
| clear() |
无 |
无 |
清空菜单项集合。 |
| hide() |
无 |
无 |
隐藏弹出菜单。 |
| removeItemByIndex(itemIndex) |
无 |
itemIndex: Integer 类型，菜单项的索引号，从 0 开始。 |
删除指定索引号的菜单项对象。 |
| show(x, y) |
无 |
x: Integer 类型，横向坐标值。
y: Integer 类型，纵向坐标值。 |
在指定的屏幕坐标位置显示弹出菜单。 |
对类 EContextMenuItem 实例化以创建弹出菜单项对象，菜单项对象包括显示文字和回调函数两部分。当用户鼠标单击菜单项后，将调用回调函数。
此类的实例用于 EContextMenu 对象的 addItem() 方法中。
构造方法返回顶部 |
| 构造方法 |
参数 |
说明 |
| EContextMenuItem(title, callbackFunction) |
title: String 类型，菜单项显示文字。
callbackFunction: Function 类型，回调函数对象 |
创建 EContextMenuItem 对象。 |
属性 |
| 方法 |
类型 |
说明 |
| title |
String |
菜单项的显示文字。 |
EEvent 类
此对象类的函数可用于注册事件处理程序（既处理自定义事件也处理 DOM 事件）和触发自定义事件。此对象类的所有方法均为静态方法。
方法 |
| 方法 |
返回类型 |
参数 |
说明 |
| addListener(source, eventName, handler) |
EEventListener 类型，返回一个可用于最终注销处理程序的句柄。 |
source: Object 类型，需要增加事件的源对象。
eventName: String 类型，事件名称。
handler: Function 类型，事件处理程序。 |
为源对象的自定义事件注册事件处理程序。返回一个可用于最终注销处理程序的句柄。事件触发时，this 将被设置为源对象，同时调用事件处理程序。 |
| clearListeners(source, eventName) |
无 |
source: Object 类型，事件源对象。
eventName: String 类型，事件名称。 |
删除使用 addListener() 为给定事件在给定对象上注册的所有处理程序。 |
| removeListener(handle) |
无 |
handle: String 类型，处理程序句柄。 |
删除使用 addListener() 注册的处理程序。 |
EIcon 类
用来显示到地图上的一个图标对象，图标指定用来在地图上显示 EMarker 的图像。此类的实例用于 EMarker 对象的构造函数中。
构造方法返回顶部 |
| 构造方法 |
参数 |
说明 |
| EIcon(imgUrl, width, height, anchorX, anchorY) |
imgUrl: String 类型，图标图像 url 。
width: Integer 类型，图标宽度，默认值为 16 像素。
height: Integer 类型，图标高度，默认值为 16 像素。
anchorX: Float 类型，表示图标与标注点的横向偏移值，默认值为 width / 2 像素。
anchorY: Float 类型，表示图标与标注点的纵向偏移值，默认值为 height / 2 像素。 |
创建 EIcon 对象。 |
属性 |
| 方法 |
类型 |
说明 |
| height |
Integer |
图标高度。 |
| width |
Integer |
图标宽度。 |
EInfoWindow 类
地图上的信息浮窗对象，可以使用 EInfoWindow 对象显示相关叠加层对象更详细的描述信息。此类实例一般用在叠加层对象的构造函数中。
构造方法返回顶部 |
| 构造方法 |
参数 |
说明 |
| EInfoWindow(title, content) |
title: String 类型，设置信息窗口标题，支持 HTML 编码格式。
content: String 类型，设置信息窗口内容，支持 HTML 编码格式。 |
创建 EInfoWindow 对象。 |
属性 |
| 方法 |
类型 |
说明 |
| title |
String |
信息窗口标题。 |
| content |
String |
信息窗口内容。 |
ELabel 类
显示在标注旁边的文字标签，通常用作描述该标注的简短信息。此类实例一般用在 EMarker 对象的构造函数中。
构造方法返回顶部 |
| 构造方法 |
参数 |
说明 |
| ELabel(text, offsetX, offsetY) |
text: String 类型，标签显示文字。
offsetX: Integer 类型，横向偏移值。
offsetY: Integer 类型，纵向偏移值。 |
创建 ELabel 对象。 |
EMarker 类
EMarker 标注地图上的位置。使用 EMaps 对象的 addOverlay() 方法添加到地图中。
标注对象包含 point（这是标注在地图中锚定的地理位置）和 icon，还有显示其描述信息的信息窗口对象。
构造方法返回顶部 |
| 构造方法 |
参数 |
说明 |
| EMarker(id, point, icon, infowindow, label) |
id: String 类型，设为空字符串""则自动生成。
point: EPoint 类型，包含此标注在地图上的地理位置信息。
icon: EIcon 类型，包含表示该标注的图像信息。
infowindow: EInfoWindow 类型，包含此标注的详细描述信息。
label: ELabel 类型，包含此标注的标签名称 |
创建 EMarker 对象。 |
属性 |
| 方法 |
类型 |
说明 |
| editable |
Boolean |
标注对象的编辑状态， true 表示标注对象现在是编辑状态。 |
| contextmenu |
EContextMenu |
标注对象的弹出菜单对象。 |
| icon |
EIcon |
标注对象的图标对象。 |
| info |
EInfoWindow |
标注对象的信息窗口对象。 |
| label |
ELabel |
标注对象的标签对象。 |
| pt |
EPoint |
标注对象的点对象。 |
EPoint 类
EPoint 是以经度和纬度表示的地理坐标点。
构造方法返回顶部 |
| 构造方法 |
参数 |
说明 |
| EPoint(lon, lat) |
lon: Number 类型，经度值。
lat: Number 类型，纬度值。 |
创建 EPoint 对象。 |
方法 |
| 方法 |
返回类型 |
参数 |
说明 |
| getLon() |
Number |
无 |
获取点对象的经度值。 |
| getLat() |
Number |
无 |
获取点对象的纬度值。 |
EPolyline 类
代表地图上的一条折线，在IE之中，将会使用VML的技术来绘制这条折线，因此必须在页面上加载VML的命名空间，在其他浏览器之中，将会使用普通的画线技术。
构造方法返回顶部 |
| 构造方法 |
参数 |
说明 |
| EPolyline(id,points, brush, infowindow) |
id: String 类型，设为空字符串""则自动生成。
points: Array 类型，包含了折线的点序列集合，它是类型为 EPoint 的对象数组。
brush: EBrush 类型，画笔对象，包含了绘制折线的样式信息。
infowindow: EInfoWindow 类型，信息窗口对象，包含折线的详细描述信息。 |
创建 EPolyline 对象。 |
属性 |
| 方法 |
类型 |
说明 |
| editable |
Boolean |
折线对象的编辑状态， true 表示折线对象现在是编辑状态。 |
| brush |
EBrush |
折线对象的画笔对象。 |
| contextmenu |
EContextMenu |
折线对象的弹出菜单对象。 |
| pts |
Array |
折线对象的点序列集合，它是类型为 EPoint 的对象数组。 |
| info |
EInfoWindow |
折线对象的信息窗口对象。 |
ELargeMapControl 类
地图平移/缩放控件，可以对地图进行上下左右四个方向的平移、缩放操作。可以使用 EMaps 对象的 showControl() 方法控制该控件的可见性。
构造方法返回顶部 |
| 构造方法 |
参数 |
说明 |
| ELargeMapControl() |
无 |
创建 ELargeMapControl 对象。 |
|
