e-ngx-services

基于Angular的一些常用的服务。

Usage

1. Install

   npm install --save e-ngx-services@latest

2. Add the ENgxServicesModule

   import {ENgxServicesModule} from "e-ngx-services";
   @NgModule({
       imports: [
           ENgxServicesModule
       ]
   })

3. Use in Typescript

   constructor(public transformService: TransformService) {
      this.transformService.wgs2gcj(160, 40); // 这里只举例，其它服务使用方法一致
   }

API

AMapWebService 高德地图web服务

Method

• setWebAPIKey(key: string): void - 设置高德Web服务API类型Key，需到高德开放平台申请

• getWebAPIKey(): string - 获取当前设置的高德Web服务API类型Key

• poiSearch(params: any): Observable<any> - 关键字搜索。params参数说明

• geocode(params: any): Observable<any> - 地理编码。params参数说明

• regeocode(params: any): Observable<any> - 逆地理编码。params参数说明

• weatherInfo(params: any): Observable<any> - 根据行政区编码获取天气预报信息。params参数说明

DateTimeService 通用日期时间操作服务

Property

• locale: any - 针对primeng中Calendar的本地配置

Method

• dateFormat(value: any, fmt: string): string - 时间格式化。value - 可转化为时间的值，fmt - 格式化模板（完整版：yyyy-MM-dd hh:mm:ss.S qq，q为季度）

• timeFormat(value: number): string - 将秒数格式化成hh:mm:ss。value - 秒数

EventsService 自定义全局事件服务

在全应用中通过发布/订阅事件来进行不同组件之间的通信

Method

• subscribe(topic: string, ...handlers: Function[]): void - 通过事件主题订阅相应事件。topic - 订阅事件的主题，handlers - 事件处理方法

• unsubscribe(topic: string, handler: Function = null): boolean - 通过事件主题取消订阅相应事件，取消成功返回true。topic - 取消订阅事件的主题，handlers - 指定取消该事件主下的处理方法

• publish(topic: string, ...args: any[]): any[] - 通过事件主题订阅相应事件。topic - 发布事件的主题，args - 通过事件发送的数据

FilePathService 文件路径操作服务（废弃，使用 FileOperationService 替代）

Interface

• FilePathInfo {path: string, name: string, extension: string, mimeType: string} - 文件路径对象，数据结构为{path: string, name: string, extension: string, mimeType: string}

Method

• resolveFilePath(filePath: string): FilePathInfo - 根据文件路径分析文件名、扩展名、mimeType。filePath - 文件完整路径

• getMimeType(extension: string): string - 根据扩展名获取mimeType。extension - 文件扩展名

FileOperationService 文件操作服务

Interface

• FilePathInfo {path: string, name: string, extension: string, mimeType: string} - 文件路径对象

• FileUploadOptions {fileKey?: string, fileName?: string, httpMethod?: string, mimeType?: string, params?: {[s: string]: any;}, onProgress?: Function} - 文件上传配置对象

• FileUploadResult {responseCode: number, response: string} - 文件上传成功返回的结果

• FileUploadError {code: number, response: string} - 文件上传失败（取消）返回的结果。code：0：取消，1：失败

• FileDownloadOptions {isSavaAs?: boolean, fileName?: string, responseType?: XMLHttpRequestResponseType, onProgress?: Function} - 文件下载配置对象

• FileDownloadResult {responseCode: number, response: string} - 文件下载成功返回的结果

• FileDownloadError {code: number, response: string} - 文件下载失败（取消）返回的结果。code：0：取消，1：失败

Class

FileOperationObject

• upload(file: ArrayBuffer | ArrayBufferView | Blob | string, serverUrl: string, options: FileUploadOptions): Promise<FileUploadResult | FileUploadError> - 文件上传

• download(serverUrl: string, options?: FileDownloadOptions): Promise<FileDownloadResult | FileDownloadError> - 文件下载

• abort(): void - 取消请求

Method

• create(): FileOperationObject - 创建一个新的 FileOperationObject

• resolveFilePath(filePath: string): FilePathInfo - 根据文件完整路径分析文件名、扩展名、mimeType

• getMimeType(extension: string): string - 根据扩展名获取mimeType

• getExtension(mimeType: string): string - 根据mimeType获取扩展名

GeolocationService 兼容W3C标准的定位服务

Interface

• Extra {type: number, gpsAccuracyStatus: number, addr: string} - 定位返回的扩展信息，只能在基于ionic开发的安卓APP中返回且依赖cordova-plugin-baidu-geolocation插件，数据结构为{type: number, gpsAccuracyStatus: number, addr: string}

• Location {watchId?: number, position: Position, extra: Extra} - 定位返回的位置信息，数据结构为{watchId?: number, position: Position, extra: Extra}

• PositionResult {code: string, info: string, result: Location} - （监测）定位返回的结果信息，数据结构为{code: string, info: string, result: Location}

Method

• getCurrentPosition(positionOptions?: PositionOptions): Observable<PositionResult> - 获取当前位置。positionOptions - 参考W3C标准中的PositionOptions对象

• watchPosition(positionOptions?: PositionOptions): Observable<PositionResult> - 持续追踪位置变更。positionOptions - 参考W3C标准中的PositionOptions对象

• clearWatch(): void - 清除位置追踪。

TransformService 地理坐标(WGS-84)、火星坐标(GCJ-02)互转服务

xxLng为xx坐标系下的经度，xxLat为xx坐标系下的纬度，均用十进制表示。

Interface

• LngLat {lng: number, lat: number} - 坐标转换返回的接口对象，数据结构为{lng: number, lat: number}

Method

• wgs2gcj(wgsLng: number, wgsLat: number): LngLat - 地理坐标(WGS-84)转火星坐标(GCJ-02)

• gcj2wgs(gcjLng: number, gcjLat: number): LngLat - 火星坐标(GCJ-02)转地理坐标(WGS-84)

EchartsLayerService arcgis 叠加 echarts（支持柱状图、散点图、线图）

Method

• init(mapComponent: any, option: any, data: any[]): void - 初始化地图上的图表。

  1. mapComponent：e-ngx-esrimap 实例，
  2. option：图表属性，同 echarts 配置项，
  3. data：对象数组[{name: string, x: number, y: number, color: string[], xData: string[], seriesData: number[]}]，name：X坐标轴名称，x：地理坐标x，y：地理坐标y，color: 颜色值，xData：x轴类目数据，seriesData：数据项

• setOption(option: any): void - 设置图表属性

• setData(data: any[]): void - 设置图表数据

• clear(): void - 清空 echarts 当前实例，会移除实例中所有的组件和图表并移除地图事件，实例可再被使用

• dispose(): void - 销毁 echarts 实例，销毁后实例无法再被使用

Develop

```shell
npm install // 安装依赖包

npm start // 启动项目
```

License