[Android] 如何用HMS Core位置和地图服务实现附近地点路径规划功能

• AGC账号注册，项目创建
  

• 注册成为开发者
  

• 创建应用，添加sha256,开启map/site开关，下载json文件
  

• 集成华为地图服务和位置服务SDK
  

• 将“agconnect-services.json”文件拷贝到应用级根目录下
  

buildscript {
  repositories {
    maven { url 'https://developer.huawei.com/repo/' }
    google()
    jcenter()
  }
  dependencies {
    classpath 'com.android.tools.build:gradle:3.3.2'
    classpath 'com.huawei.agconnect:agcp:1.3.1.300'
  }
}
allprojects {
  repositories {
    maven { url 'https://developer.huawei.com/repo/' }
    google()
    jcenter()
  }
}

• 在“dependencies ”中添加如下编译依赖
  

dependencies {
  implementation 'com.huawei.hms:maps:{version}'
  implementation 'com.huawei.hms:site:{version}'
}

• 在文件头添加配置
  

apply plugin: 'com.huawei.agconnect'

• 在android中配置签名。将生成签名证书指纹生成的签名文件复制到您工程的app目录下，并在“build.gradle”文件中配置签名
  

signingConfigs {
  release {
    // 签名证书
      storeFile file("**.**")
      // 密钥库口令
      storePassword "******"
      // 别名
      keyAlias "******"
      // 密钥口令
      keyPassword "******"
      v2SigningEnabled true
    v2SigningEnabled true
  }
}
buildTypes {
  release {
    minifyEnabled false
    proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
    debuggable true
  }
  debug {
    debuggable true
  }
}

• 项目中用到的主要代码及功能
  

• 文本搜索：通过实现位置服务中的textSearch功能实现文本内容搜索并展示出来。
  

SearchResultListener<TextSearchResponse> resultListener = new SearchResultListener<TextSearchResponse>() {
  // Return search results upon a successful search.
  @Override
  public void onSearchResult(TextSearchResponse results) {
    List<Site> siteList;
    if (results == null || results.getTotalCount() <= 0 || (siteList = results.getSites()) == null
        || siteList.size() <= 0) {
      resultTextView.setText("Result is Empty!");
      return;
    }
    mFirstAdapter.refresh(siteList);
    StringBuilder response = new StringBuilder("\n");
    response.append("success\n");
    int count = 1;
    AddressDetail addressDetail;
    Coordinate location;
    Poi poi;
    CoordinateBounds viewport;
    for (Site site : siteList) {
      addressDetail = site.getAddress();
      location = site.getLocation();
      poi = site.getPoi();
      viewport = site.getViewport();
      response.append(String.format(
          "[%s] siteId: '%s', name: %s, formatAddress: %s, country: %s, countryCode: %s, location: %s, poiTypes: %s, viewport is %s \n\n",
          "" + (count++), site.getSiteId(), site.getName(), site.getFormatAddress(),
          (addressDetail == null ? "" : addressDetail.getCountry()),
          (addressDetail == null ? "" : addressDetail.getCountryCode()),
          (location == null ? "" : (location.getLat() + "," + location.getLng())),
          (poi == null ? "" : Arrays.toString(poi.getPoiTypes())),
          (viewport == null ? "" : viewport.getNortheast() + "," + viewport.getSouthwest())));
    }
    resultTextView.setText(response.toString());
    Log.d(TAG, "onTextSearchResult: " + response.toString());
  }
  // Return the result code and description upon a search exception.
  @Override
  public void onSearchError(SearchStatus status) {
    resultTextView.setText("Error : " + status.getErrorCode() + " " + status.getErrorMessage());
  }
};
// Call the place search API.
searchService.textSearch(request, resultListener);

• 步行路径规划:通过调用地图服务的api接口实现数据回调并呈现在地图上。
  

NetworkRequestManager.getWalkingRoutePlanningResult(latLng1, latLng2,
    new NetworkRequestManager.OnNetworkListener() {
      @Override
      public void requestSuccess(String result) {
        generateRoute(result);
      }
      @Override
      public void requestFail(String errorMsg) {
        Message msg = Message.obtain();
        Bundle bundle = new Bundle();
        bundle.putString("errorMsg", errorMsg);
        msg.what = 1;
        msg.setData(bundle);
        mHandler.sendMessage(msg);
      }
    });