PeliasGeocoderService

PeliasGeocoderService是一个基于Pelias地理编码API的CesiumJS地图库的服务类，它可以在CesiumJS地图中进行地理编码和反地理编码操作。

安装

在您的CesiumJS项目中，使用npm安装PeliasGeocoderService：

npm install cesium-pelias-geocoder-service --save

用法

要使用PeliasGeocoderService，您需要获取Pelias API的密钥。 您可以从Pelias官方网站上申请一个。

首先，需要将PeliasGeocoderService引入你的代码中：

import PeliasGeocoderService from 'cesium-pelias-geocoder-service';

然后，您需要创建一个PeliasGeocoderService实例：

const pelias = new PeliasGeocoderService({ url: 'https://search.mapzen.com/v1', apiKey: 'your-api-key', });

在这里，url参数是Pelias API的URL，apiKey参数是您的Pelias API密钥。

PeliasGeocoderService方法

下面是可以在PeliasGeocoderService上使用的方法：

forwardGeocode(query)

此方法可以用于执行地理编码操作。 它将接受一个字符串，并返回一个Promise对象，该对象将在编码成功时解析为包含与查询匹配的地理位置的数组。

pelias.forwardGeocode('New York') .then((results) => { console.log(results[0].name); // 输出：'New York, NY' });

reverseGeocode(position)

此方法可以用于执行反地理编码操作。 它将接受一个Cartesian3对象，并返回一个Promise对象，该对象将在解码成功时解析为包含与位置匹配的地理位置的数组。

const position = Cartesian3.fromDegrees(-74.0758, 40.679); pelias.reverseGeocode(position) .then((results) => { console.log(results[0].street); // 输出：'5th Ave.' });

getSuggestions(query)

此方法可用于获取与查询匹配的建议地方名称。 它将接受一个字符串，并返回一个Promise对象，该对象将在成功时解析为包含建议地方名称的数组。

pelias.getSuggestions('Time Squ') .then((suggestions) => { console.log(suggestions[0]); // 输出：'Times Square' });

选项

PeliasGeocoderService还支持一些附加选项：

• countryCodes: 用逗号分隔的ISO 2字母国家代码列表，限制只在这些国家进行地理编码。 示例："countryCodes: 'us,ca'"。

完整示例

这是一个完整的示例，用于在CesiumJS地图中进行地理编码和反地理编码：

import Cesium from 'cesium/Cesium'; import Cartesian3 from 'cesium/Core/Cartesian3'; import PeliasGeocoderService from 'cesium-pelias-geocoder-service';

const viewer = new Cesium.Viewer('cesiumContainer');

const pelias = new PeliasGeocoderService({ url: 'https://search.mapzen.com/v1', apiKey: 'your-api-key', });

// 地理编码 pelias.forwardGeocode('New York') .then((results) => { const location = results[0].geometry.coordinates; viewer.camera.flyTo({ destination: Cartesian3.fromDegrees(location[0], location[1], 10000), }); });

// 反地理编码 viewer.screenSpaceEventHandler.setInputAction((evt) => { const position = viewer.camera.pickEllipsoid(evt.position, viewer.scene.globe.ellipsoid); if (position !== undefined) { pelias.reverseGeocode(position) .then((results) => { console.log(results[0]); }); } }, Cesium.ScreenSpaceEventType.LEFT_CLICK);

// 建议 pelias.getSuggestions('Time Squ') .then((suggestions) => { console.log(suggestions); });