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

# 格式化要傳送至 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` 會在每個引號 (**"**) 中加入逸出字元 **\\**。