本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 为 E911 的实际地址设置格式，以便传递给 Amazon Connect
<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_cn/connect/latest/adminguide/images/e911-example-mapping-scheme.png)


下表显示了键的完整列表。


| 属性名称 | 说明 | 示例 | 必需 | 字符限制 | 建议的字符限制 | 
| --- | --- | --- | --- | --- | --- | 
|  country  | 国家/地区由两个字母的 ISO 3166 代码标识。  | 美国  | 必需  | 2  |   | 
|  A1  | 国家行政区划（州、地区、省、县）  | NY  | 必需  | 2  |   | 
|  A3  | 市、镇、shi（日本）  | New York  | 必需  | 32  |   | 
|  PRD  | 主要街道方向  | 北、西  | 仅在适用于地址时才为必填项  | 2  |   | 
|  POD  | 尾随街道后缀  | 西南  | 仅在适用于地址时才为必填项  | 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 函数检索到的位置在传递给 Amazon Connect 之前，需要转换为 JSON 字符串。例如，使用 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** 添加到每个引号 (**"**) 中。