本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 格式化要傳送至 Amazon Connect 的 E911 實體地址
<a name="connect-format-physical-address-e911"></a>

本主題說明如何格式化實體地址，以便將其傳送至 Amazon Connect。

E911 外撥電話需要將實體地址以 JSON 字串形式傳遞至 Amazon Connect，其中包含代表地址中各個欄位的索引鍵和值。例如，請參閱下列美國地址：
+ 2121 7th Ave, Seattle, WA, 98121, USA

此位址必須以 JSON 字串形式連接至金鑰 `CivicAddress`，如下列範例所示。每個位址欄位都附加到特定的編碼金鑰。

 `CivicAddress: {"country":"USA","RD":"7th","A3":"Seattle","PC":"98121","HNO":"2121","STS":"Ave","A1":"WA"}`

下圖顯示範例輸入地址如何對應到 [PSAP](https://en.wikipedia.org/wiki/Public_safety_answering_point) 地址索引鍵：

![\[實體地址與 PSAP 地址索引鍵的對應。\]](http://docs.aws.amazon.com/zh_tw/connect/latest/adminguide/images/e911-example-mapping-scheme.png)


下表顯示完整的金鑰清單。


| 屬性名稱 | 描述 | 範例 | 必要 | 字元限制 | 建議字元限制 | 
| --- | --- | --- | --- | --- | --- | 
|  國家/地區  | 國家/地區由兩個字母的 ISO 3166 代碼來識別。  | 美國  | 必要  | 2  |   | 
|  A1  | 國家行政區 (州，地區，省，縣)  | NY  | 必要  | 2  |   | 
|  A3  | 市、鄉、市 (JP)  | 紐約  | 必要  | 32  |   | 
|  珠江三角洲  | 前導街道方向  | N, W  | 僅在適用於地址時才需要  | 2  |   | 
|  Pod  | 尾隨街道字尾  | SW  | 僅在適用於地址時才需要  | 2  |   | 
|  STS  | 街道字尾  | 大道、廣場  | 僅在適用於地址時才需要  | 5  |   | 
|  HNO  | 門牌號碼 (僅限數字部分)  | 2121  | 必要  | 10  |   | 
|  HNS  | 門牌號碼字尾  | A，1/2  | 僅在適用於地址時才需要  | 4  |   | 
|  LOC  | 其他位置資訊  | 543 號聊天室  | 選用  | 60  | 20 人或更少  | 
|  NAM  | 姓名 (居住地，企業或辦公室住戶)  | 範例公司  | 選用  | 32  |   | 
|  PC  | 郵遞區號  | 10027  | 必要  | 5  |   | 
|  RD  | 主要道路或街道  | 百老匯  | 必要  | 40  |   | 

**注意**  
您有責任根據標準儲存庫來驗證位址，例如主要街道地址指南 (MSAG)。

## 程式設計備註
<a name="connect-e911-programming-notes"></a>

目前，無法將 JSON 結構作為 `Attribute` 傳遞給 Amazon Connect。因此，Lambda 函數擷取的位置必須先轉換為 JSON 字串，然後才能傳遞至 Amazon Connect。例如，使用 Python 程式語言，如果擷取的位置儲存於 JSON 結構 `json_agent_location` 中，則可將其傳遞到 Amazon Connect (從 Lambda 函數)，如下所示：

`return { ,'CivicAddress': json.dumps(json_agent_location) ,'agent_did_number': '+15555551212' }`

對於地址，例如以下範例：
+ 2121 7th Ave, Seattle, WA, 98121, USA

鍵值對：

`CivicAddress: {"country": "USA", "RD": "7th", "A3": "Seattle", "PC": "98121", "HNO": "2121", "STS": "Ave", "A1": "WA"}`

以及實際傳遞給 Amazon Connect 的相應 JSON 字串：

`CivicAddress: {\"country\": \"USA\", \"RD\": \"7th\", \"A3"\: \"Seattle\", \"PC\": \"98121\", \"HNO\": \"2121\", \"STS\": \"Ave\", \"A1\": \"WA\"}`

**注意**  
使用 `json.dumps` 會在每個引號 (**"**) 中加入逸出字元 **\$1**。