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

# 为 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` 会将一个转义字符 **\\** 添加到每个引号 (**"**) 中。