本文大綱
1.   專案背景
2.   整合準備
3.   主要程式碼
4.   成果展示

# 一、本專案用到的功能點:
地圖服務（Map Kit）給您提供一套地圖開發呼叫的SDK，地圖資料覆蓋超過200個國家和地區，支援數百種語言，方便您輕鬆地在應用中整合地圖相關的功能，全方位提升使用者體驗。

關鍵字搜尋：透過指定的關鍵字和可選的地理範圍，查詢諸如旅遊景點、企業和學校之類的地點。

路徑規劃： 是一套以HTTPS形式提供的步行、騎行、駕車路徑規劃以及行駛距離計算介面，透過JSON格式返回路徑查詢資料，提供路徑規劃能力。

# 二、整合準備
### 1. AGC賬號註冊，專案建立
1)  註冊成為開發者

註冊地址：
[https://developer.huawei.com/consumer/cn/service/josp/agc/index.html?ha_source=hms1](https://developer.huawei.com/consumer/cn/service/josp/agc/index.html?ha_source=hms1)

![在這裡插入圖片描述](https://img-blog.csdnimg.cn/20210114095657309.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDcwODI0MA==,size_16,color_FFFFFF,t_70#pic_center)

1)   建立應用，新增sha256,開啟map/site開關，下載json檔案

![在這裡插入圖片描述](https://img-blog.csdnimg.cn/20210114095754790.png#pic_center)

### 2.  整合Map + Site SDK
1)  將“agconnect-services.json”檔案複製到應用級根目錄下
- 在“allprojects > repositories”中配置HMS Core SDK的Maven倉地址。
- 在“buildscript > repositories”中配置HMS Core SDK的Maven倉地址。
- 如果App中新增了“agconnect-services.json”檔案則需要在“buildscript > dependencies”中增加agcp配置。

```java
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()
     }
 }
```

2) 在“dependencies ”中新增如下編譯依賴

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

3)  在檔案頭新增配置

```java
apply plugin: 'com.huawei.agconnect'
```

4) 在android中配置簽名。將生成簽名證照指紋生成的簽名檔案複製到您工程的app目錄下，並在“build.gradle”檔案中配置簽名。

```java
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
    }
}
```

# 三、  專案中用到的主要程式碼及功能
1. 文字搜尋：透過實現Site Kit中的textSearch功能實現文字內容搜尋並展示出來。

```java
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);
```

1. 步行路徑規劃:透過呼叫Map Kit 中的API介面實現資料回撥並呈現在地圖上。點選可獲取API文件。

```java
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);
            }
        });
```

四、專案成果展示

![在這裡插入圖片描述](https://img-blog.csdnimg.cn/2021011410190815.gif#pic_center)

欲瞭解更多詳情，請參閱：
華為開發者聯盟官網：https://developer.huawei.com/consumer/cn/hms?ha_source=hms1
獲取開發指導文件：https://developer.huawei.com/consumer/cn/doc/development?ha_source=hms1
參與開發者討論請到Reddit社群：https://www.reddit.com/r/HuaweiDevelopers/
下載demo和示例程式碼請到Github：https://github.com/HMS-Core
解決整合問題請到Stack Overflow：[https://stackoverflow.com/questions/tagged/huawei-mobile-services?tab=Newest](https://stackoverflow.com/questions/tagged/huawei-mobile-services?tab=Newest)

---
原文連結：[https://developer.huawei.com/consumer/cn/forum/topic/0202436666167160224?fid=18](https://developer.huawei.com/consumer/cn/forum/topic/0202436666167160224?fid=18)

原作者：胡椒</site></textsearchresponse></textsearchresponse>

簡單的路徑規劃案例分享

相關文章