开发指南

地图服务是指那些提供数据信息的接口，比如POI搜索、驾车导航、公交路线、地理编码、纠偏贴路等。提供的服务有：

服务名称	描述	详细说明
PlaceSearch	兴趣点（POI）搜索	提供兴趣点的位置检索、周边检索和范围检索。
AutoComplete	输入提示	提供检索输入框快速提供结果。
DistrictSearch	行政区检索	提供省市区行政区的检索。
WeatherSearch	天气检索	提供城市天气检索。
Driving	驾车规划	提供驾车出行方案的搜索服务。
Transit	公交路线	提供公交换乘方案的搜索服务。
Walking	步行规划	提供驾车出行方案的搜索服务。
Geocoder	地理编码/逆地理编码	提供将地址信息转换为坐标点信息的服务。
IpLocation	IP定位	提供通过用户IP定位所在位置。
Geolocation	浏览器定位	提供浏览器定位服务，需要浏览器支持。
Correction	纠偏贴路服务	提供点，轨迹的贴路、纠偏服务。

KMap.PlaceSearch提供兴趣点搜索服务，在使用兴趣点搜索时可以全国关键字检索，也支持城市内检索，周边检索、多边形内检索等。

let placeSearch = new KMap.PlaceSearch({
    map: map
});
placeSearch.search({
    keyword:'肯德基',
    start:0,
    count:20
});

另外，KMap.PlaceSearch还提供包含searchInRegion、searchInBounds、searchAround和searchInPolygon方法，为您提供周边搜索和范围搜索服务。
除了搜索结果会自动添加到地图外，您可以在执行检索方法的时候，使用callback回调函数获取结果集，通过结果集对象可以获取详细的数据信息。
在下面这个示例中，通过回调函数得到城市结果集信息，并输出到页面上：

let placeSearch = new KMap.PlaceSearch({
    map: map
});
placeSearch.search({
    keyword:'肯德基',
    start:0,
    count:20
},(status, result) => {
    if(status == 'complete') {
        let pois = result.getSuggestCites();
        let html = [];
        for (let poi of pois) {
            html.push(poi.name + '('+ poi.count +')');
        }
        document.getElementById('result').innerHTML = html.join('<br>');
    }
});

在下面这个示例中，通过城市检索直接获取POI列表：

let placeSearch = new KMap.PlaceSearch({
    map: map
});
placeSearch.searchInRegion({
    city:'深圳市',
    keyword:'肯德基',
    start:0,
    count:20
});

KMap.Driving提供驾车规划服务。
下面示例展示了如何使用驾车规划接口：

let driving = new KMap.Driving({
    map: map,
    showTraffic: true
});
driving.search([{
    keyword:"创建大厦",
    city:"深圳市"
},{
    keyword:"深圳机场",
    city:"深圳市"
}]);

下面示例中，我们提供了结果面板panel参数，方案描述会自动展示到此panel容器中。

let driving = new KMap.Driving({
    map: map,
    panel: 'result',
    showTraffic: true
});
driving.search([{
    keyword:"创建大厦",
    city:"深圳市"
},{
    keyword:"深圳机场",
    city:"深圳市"
}]);

驾车导航服务也提供了丰富的数据接口，通过回调函数可以得到Careland.DrivingRouteResult对象，它包含了驾车导航结果数据信息。结果会包含多条驾车方案，每条方案中包含路段信息、导航信息、里程信息、预计时间信息等。可通过结果集DrivingResult获得。

let driving = new KMap.Driving({
    map: map
});
driving.search([{
    keyword:"创建大厦",
    city:"深圳市"
},{
    keyword:"深圳机场",
    city:"深圳市"
}],(status,result) => {
    if(status == 'complete') {
        let html = [];
        html.push('起点：'+result.origin.name);
        html.push('终点：'+result.destination.name);
        if(result.routes.length > 0) {
            html.push(result.routes[0].tag);
            html.push('里程：'+ result.routes[0].distance + '米');
            html.push('时间：'+ result.routes[0].time + '秒');
            html.push('红绿灯：'+ result.routes[0].trafficLight);
        }
        document.getElementById('result').innerHTML = html.join('<br>');
    }
});

KMap.Transit提供公交路线服务。
下面示例展示了如何使用公交路线接口：

let transit = new KMap.Transit({
    map : map
});
transit.search([{
    keyword:"创建大厦",
    city:"深圳市"
},{
    keyword:"深圳机场",
    city:"深圳市"
}]);

下面示例中，我们提供了结果面板panel参数，方案描述会自动展示到此panel容器中。

let transit = new KMap.Transit({
    map : map,
    panel: 'result'
});
transit.search([{
    keyword:"创建大厦",
    city:"深圳市"
},{
    keyword:"深圳机场",
    city:"深圳市"
}]);

公交路线服务也提供了丰富的数据接口，通过回调函数可以得到KMap.TransferResult结果集，它包含了公交换乘结果数据信息。

let transit = new KMap.Transit({
    map : map
});
transit.search([{
    keyword:"创建大厦",
    city:"深圳市"
},{
    keyword:"深圳机场",
    city:"深圳市"
}],(status,result) => {
    if(status == 'complete') {
        let html = [];
        html.push('起点：'+result.origin.name);
        html.push('终点：'+result.destination.name);
        for (let route of result.routes) {
            html.push(route.name);
            for (let step of route.steps) {
                html.push(step.name + '('+ step.start.name + '-' + step.end.name +')');
            }
        }
        document.getElementById('result').innerHTML = html.join('<br>');
    }
});

地理编码，通过Geocoder.getLocation()方法通过地址获取坐标。当解析工作完成后，您提供的回调函数将会被触发。如果解析成功，则回调函数的参数为GeoCoderResult。

// 创建实例
let geoCoder = new KMap.Geocoder();
// 地理编码
geoCoder.getLocation({
    address : '你的地址'
},(status,result) => {
    if(status == 'complete') {
        if(result.list.length > 0) {
            console.log(result.list[0].location);
        }
    }
    else {
        alert('解析失败['+result+']');
    }
});

逆地理编码，您可以通过Geocoder.getAddress()方法通过坐标获得地址描述。当解析工作完成后，您提供的回调函数将会被触发。如果解析成功，则回调函数的参数为ReGeoCoderResult对象。

// 创建实例
let geoCoder = new KMap.Geocoder();
// 逆地理编码
geoCoder.getAddress({
    location: new KMap.Point(114.023144,22.535019)
},(status,result) => {
    if(status == 'complete') {
        if(result.list.length > 0) {
            console.log(result.list[0].address);
        }
    }
    else {
        alert('解析失败['+result+']');
    }
});

根据一个带方向的坐标点得到这个点定位在具体的路上你的位置及道路相关信息。您可以通过Correction.pointGraspRoad()方法获得抓路后的结果。当服务调用完成后，您提供的回调函数将会被触发。

// 创建实例
let correction = new KMap.Correction();
// 单点抓路
correction.pointGraspRoad(new KMap.Point(114.026067,22.536282),
    90,
    function (status,result) {
        if(status == 'complete') {
            //显示
            console.log(result);
        }
        else {
            //错误
            alert(result);
        }
});

根据一条连续的轨迹坐标点，得到这段轨迹具体的贴到道路上的驾车轨迹信息及里程等。您可以通过Correction.trackGraspRoad()方法获得抓路后的结果。当服务调用完成后，您提供的回调函数将会被触发。

// 创建实例
let correction = new KMap.Correction();
// 轨迹贴路
let track = [{"lon":113.87038,"lat":23.07192306,"speed":20,"direction":202,"time":1557314269},{"lon":113.87026,"lat":23.07168639,"speed":11,"direction":183,"time":1557314275}];
correction.trackGraspRoad(track,function (status,result) {
     if(status == 'complete') {
         //显示
         console.log(result);
     }
     else {
         //错误
         alert(result);
     }
});