GA《公安交管綜合警務(wù)APP對(duì)接技術(shù)要求》

GA/T—XXXX

公安交管綜合警務(wù)APP對(duì)接技術(shù)要求

1范圍

本文件規(guī)定了第三方應(yīng)用對(duì)接公安交管綜合警務(wù)APP的總體架構(gòu)和接口協(xié)議要求。

本文件適用于對(duì)接公安交管綜合警務(wù)APP的第三方應(yīng)用的設(shè)計(jì)、建設(shè)和運(yùn)行維護(hù)。

2規(guī)范性引用文件

本文件無(wú)規(guī)范性引用文件。

3術(shù)語(yǔ)和定義

下列術(shù)語(yǔ)和定義適用于本文件。

3.1

移動(dòng)警務(wù)終端mobilepoliceterminal

在移動(dòng)警務(wù)系統(tǒng)中處理警務(wù)信息的無(wú)線終端設(shè)備。

[來(lái)源：GA/T1561—2019]

3.2

原生應(yīng)用nativeapp

指直接運(yùn)行于Android操作系統(tǒng)、基于AndroidSDK/NDK編寫的應(yīng)用程序。

3.3

第三方應(yīng)用third-partyapp

指除公安交管綜合警務(wù)APP之外，運(yùn)行在移動(dòng)警務(wù)終端上的其他原生應(yīng)用。

3.4

模塊module

第三方應(yīng)用的每一個(gè)獨(dú)立功能稱為一個(gè)模塊。

3.5

應(yīng)用間交互inter-applicationinteraction

指用戶操作公安交管綜合警務(wù)APP與第三方應(yīng)用進(jìn)行交互，包括業(yè)務(wù)交互及快捷跳轉(zhuǎn)兩種形式。業(yè)

務(wù)交互指在跳轉(zhuǎn)至第三方應(yīng)用時(shí)可傳遞部分所需參數(shù)，用于第三方應(yīng)用后續(xù)業(yè)務(wù)。快捷跳轉(zhuǎn)指公安交管

綜合警務(wù)APP僅提供跳轉(zhuǎn)至第三方應(yīng)用模塊的入口。

3.6

1

GA/T—XXXX

接口協(xié)議interfaceprotocol

公安交管綜合警務(wù)APP與第三方應(yīng)用實(shí)現(xiàn)應(yīng)用間交互的協(xié)議。

4縮略語(yǔ)

下列縮略語(yǔ)適用于本文件。

APP：移動(dòng)應(yīng)用（Application）

URL：統(tǒng)一資源定位符（UniformResourceLocator）

5總體架構(gòu)

公安交管綜合警務(wù)APP對(duì)接技術(shù)的總體架構(gòu)由公安交管綜合警務(wù)平臺(tái)APP、第三方應(yīng)用及其模塊、應(yīng)

用間交互類型以及接口協(xié)議組成（見圖1）。公安交管綜合警務(wù)APP與第三方應(yīng)用須同時(shí)運(yùn)行于移動(dòng)警務(wù)

終端中，通過接口協(xié)議，實(shí)現(xiàn)應(yīng)用間交互，第三方應(yīng)用功能模塊可以作為公安交管綜合警務(wù)APP的有效

補(bǔ)充。

圖1公安交管綜合警務(wù)APP對(duì)接技術(shù)總體架構(gòu)圖

6接口協(xié)議要求

6.1第三方應(yīng)用模塊要求

6.1.1模塊分類與注冊(cè)

第三方應(yīng)用的模塊分為業(yè)務(wù)交互模塊和快捷跳轉(zhuǎn)模塊兩類。

2

GA/T—XXXX

每個(gè)模塊包括模塊路徑、模塊名稱、模塊類型、模塊圖標(biāo)、模塊功能介紹及審批狀態(tài)，第三方應(yīng)用與公

安交管綜合警務(wù)APP的對(duì)接與交互皆基于模塊進(jìn)行。

業(yè)務(wù)交互模塊注冊(cè)時(shí)，由公安交管綜合警務(wù)APP提供模塊名稱、模塊圖標(biāo)、模塊類型、模塊功能介

紹、是否返回結(jié)果，由第三方應(yīng)用提供模塊路徑。

快捷跳轉(zhuǎn)模塊注冊(cè)時(shí)，由公安交管綜合警務(wù)APP提供模塊類型，由第三方應(yīng)用提供模塊路徑、模塊

名稱、模塊圖標(biāo)、模塊功能介紹、是否返回結(jié)果。

注冊(cè)所需內(nèi)容見表1。

表1模塊注冊(cè)所需內(nèi)容

業(yè)務(wù)交互模塊快捷跳轉(zhuǎn)模塊

模塊路徑必填必填

模塊名稱由公安交管綜合警務(wù)APP提供必填

模塊圖標(biāo)由公安交管綜合警務(wù)APP提供必填

模塊類型由公安交管綜合警務(wù)APP提供由公安交管綜合警務(wù)APP提供

模塊功能介紹由公安交管綜合警務(wù)APP提供必填

是否返回結(jié)果由公安交管綜合警務(wù)APP提供必填

6.1.2模塊路徑協(xié)議格式

模塊路徑即URLScheme，公安交管綜合警務(wù)APP可通過此協(xié)議來(lái)調(diào)用系統(tǒng)跳轉(zhuǎn)功能，跳轉(zhuǎn)至第三

方應(yīng)用的具體模塊。

URLScheme格式：

<scheme>://<host>:<port>/<path>?<query>

公安交管綜合警務(wù)APP使用的模塊路徑協(xié)議格式應(yīng)符合表2的規(guī)定。

表2模塊路徑協(xié)議格式

URLScheme部分內(nèi)容備注

schemelink固定值不可修改

host第三方應(yīng)用包名

port空無(wú)需填寫

path模塊簡(jiǎn)稱

query參數(shù)列表，具體應(yīng)符合表3的規(guī)定URL參數(shù)

示例：

link://com.abc.app/module?yhdh=%s¶m1=%s

通過此模塊路徑，將跳轉(zhuǎn)至包名為com.abc.app的第三方應(yīng)用，打開module模塊，并傳遞參數(shù)yhdh、prams1至

第三方應(yīng)用。

6.1.3參數(shù)傳遞及返回結(jié)果

公安交管綜合警務(wù)APP通過模塊路徑傳遞參數(shù)至第三方應(yīng)用模塊。

若第三方應(yīng)用模塊屬于業(yè)務(wù)交互模塊，則模塊業(yè)務(wù)結(jié)束后，應(yīng)返回結(jié)果至公安交管綜合警務(wù)APP。

若第三方應(yīng)用模塊屬于快捷跳轉(zhuǎn)模塊，則模塊業(yè)務(wù)結(jié)束后，無(wú)需返回結(jié)果。

參數(shù)傳遞及返回結(jié)果的格式要求見表3，其中除用戶代號(hào)為固定值必傳外，其余參數(shù)均可根據(jù)實(shí)際

業(yè)務(wù)需要自行定義。

表3參數(shù)傳遞及返回結(jié)果格式要求

數(shù)據(jù)類型參數(shù)名參數(shù)說明

參數(shù)傳遞yhdh用戶代號(hào)，必傳

3

GA/T—XXXX

表3參數(shù)傳遞及返回結(jié)果格式要求（續(xù)）

數(shù)據(jù)類型參數(shù)名參數(shù)說明

param1自定義參數(shù)1，可選

param2自定義參數(shù)2，可選

param3自定義參數(shù)3，可選

yhdh用戶代號(hào)，如需返回結(jié)果則必傳

result1自定義返回參數(shù)1，可選

返回結(jié)果

result2自定義返回參數(shù)2，可選

result3自定義返回參數(shù)3，可選

6.2第三方應(yīng)用對(duì)接改造要求

6.2.1改造原則

第三方應(yīng)用的改造應(yīng)修改AndroidManifest.xml文件，獲取公安交管綜合警務(wù)APP傳遞的參數(shù)，完

成相應(yīng)模塊業(yè)務(wù)，并可返回結(jié)果至公安交管綜合警務(wù)APP。

6.2.2修改AndroidManifest.xml

在第三方應(yīng)用的AndroidManifest.xml文件中，為已注冊(cè)模塊的Activity添加intent-filter，

根據(jù)模塊注冊(cè)時(shí)填寫的的模塊路徑填寫host、path、scheme值。

示例：

<intent-filter>

<data

android:host="com.abc.app"

android:path="/module"

android:scheme="link"/>

<categoryandroid:name="ent.category.DEFAULT"/>

<actionandroid:name="ent.action.VIEW"/>

</intent-filter>

6.2.3獲取參數(shù)

在第三方應(yīng)用模塊中，獲取Intent中的URL地址，并解析參數(shù)，用于后續(xù)業(yè)務(wù)。

示例：

Intentintent=getIntent();

Uriuri=intent.getData();

if(uri!=null){

Stringurl=uri.toString();

//第三方應(yīng)用包名

Stringhost=uri.getHost();

//模塊簡(jiǎn)稱

Stringpath=uri.getPath();

//參數(shù)列表

StringqueryString=uri.getQuery();

Stringyhdh=uri.getQueryParameter("yhdh");

Stringparam1=uri.getQueryParameter("param1");

4

GA/T—XXXX

}

6.2.4完成業(yè)務(wù)及返回

第三方應(yīng)用模塊完成相應(yīng)業(yè)務(wù)后，應(yīng)當(dāng)返回公安交管綜合警務(wù)APP。

無(wú)結(jié)果返回

若第三方應(yīng)用無(wú)需返回結(jié)果，則直接返回。

有結(jié)果返回

若第三方應(yīng)用需返回結(jié)果至公安交管綜合警務(wù)APP，需通過Intent按表3中數(shù)據(jù)格式，返回結(jié)果及數(shù)

據(jù)數(shù)據(jù)。

示例：

Intentintent=newIntent();

intent.putExtra("yhdh",yhdh);

intent.putExtra("result1",result1);

//如用戶未完成相應(yīng)模塊業(yè)務(wù)，則改為setResult(RESULT_CANCELED,intent);

setResult(RESULT_OK,intent);

5

GA/T—XXXX

參考文獻(xiàn)

[1]GA/T1561—2019移動(dòng)警務(wù)系統(tǒng)總體技術(shù)要求

[2]公安交通管理科技發(fā)展規(guī)劃（2021-2023年）（公交管[2020]300號(hào)）

_________________________________

6

ICS35.08

CCSL73

GA

中華人民共和國(guó)公共安全行業(yè)標(biāo)準(zhǔn)

GA/TXXXX—XXXX

公安交管綜合警務(wù)APP對(duì)接技術(shù)要求

TechnicalrequirementsforthedockingofintegratedpoliceAPPforPublicSecurity

TrafficManagement

（征求意見稿）

（在提交反饋意見時(shí)，請(qǐng)將您知道的相關(guān)專利連同支持性文件一并附上。）

XXXX-XX-XX發(fā)布XXXX-XX-XX實(shí)施

中華人民共和國(guó)公安部發(fā)布

GA/T—XXXX

公安交管綜合警務(wù)APP對(duì)接技術(shù)要求

1范圍

本文件規(guī)定了第三方應(yīng)用對(duì)接公安交管綜合警務(wù)APP的總體架構(gòu)和接口協(xié)議要求。

本文件適用于對(duì)接公安交管綜合警務(wù)APP的第三方應(yīng)用的設(shè)計(jì)、建設(shè)和運(yùn)行維護(hù)。

2規(guī)范性引用文件

本文件無(wú)規(guī)范性引用文件。

3術(shù)語(yǔ)和定義

下列術(shù)語(yǔ)和定義適用于本文件。

3.1

移動(dòng)警務(wù)終端mobilepoliceterminal

在移動(dòng)警務(wù)系統(tǒng)中處理警務(wù)信息的無(wú)線終端設(shè)備。

[來(lái)源：GA/T1561—2019]

3.2

原生應(yīng)用nativeapp

指直接運(yùn)行于Android操作系統(tǒng)、基于AndroidSDK/NDK編寫的應(yīng)用程序。

3.3

第三方應(yīng)用third-partyapp