OpenCageGeocoderService

OpenCageGeocoderService是一个Cesium的地理编码服务插件，使用OpenCage Geocoder API实现地理编码和逆地理编码功能。

用法

// 创建OpenCageGeocoderService对象
var service = new Cesium.OpenCageGeocoderService({
    apiKey: '你的API Key'
});

// 地理编码
var geocode = function(address) {
    service.geocode(address).then(function(result) {
        console.log(result);
    }).otherwise(function(error) {
        console.log(error);
    });
};

// 逆地理编码
var reverseGeocode = function(position) {
    service.reverseGeocode(position).then(function(result) {
        console.log(result);
    }).otherwise(function(error) {
        console.log(error);
    });
};

构造函数

new Cesium.OpenCageGeocoderService(options)

创建一个OpenCageGeocoderService对象。

参数

• options：一个包含以下属性的对象。
  • apiKey：String类型，必需，OpenCage Geocoder API的API Key。
  • language：String类型，可选，返回结果的语言设置。默认为英语（en）。

方法

geocode(address)

地理编码，将地名或地址转化为经纬度坐标。

参数

• address：String类型，必需，需要进行地理编码的地址或地名。

返回

• Promise：一个Promise对象，包含以下属性。
  • latitude：Number类型，纬度坐标，单位为度。
  • longitude：Number类型，经度坐标，单位为度。
  • displayName：String类型，地名或地址。
  • address：一个包含详细地址信息的对象。

reverseGeocode(position)

逆地理编码，将经纬度坐标转化为地址或地名。

参数

• position：Cartesian3类型，必需，需要进行逆地理编码的坐标。

返回

• Promise：一个Promise对象，包含以下属性。
  • latitude：Number类型，纬度坐标，单位为度。
  • longitude：Number类型，经度坐标，单位为度。
  • displayName：String类型，地名或地址。
  • address：一个包含详细地址信息的对象。

异常

如果发生错误，以上方法会返回一个带有message属性的Error对象。