

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Formatar um endereço físico para o E911 passar para o Amazon Connect
<a name="connect-format-physical-address-e911"></a>

Este tópico explica como formatar um endereço físico para que ele possa ser passado para o Amazon Connect.

As chamadas de saída do E911 exigem que um endereço físico seja passado para o Amazon Connect como uma string JSON com chaves e valores que representam os vários campos no endereço. Por exemplo, considere o seguinte endereço dos EUA:
+ 2121 7th Ave, Seattle, WA, 98.121, USA

O endereço deve ser anexado como uma string de JSON à chave `CivicAddress`, conforme mostrado no exemplo a seguir. Cada campo de endereço é anexado a uma chave codificada específica. 

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

A ilustração a seguir mostra como um exemplo de endereço de entrada é mapeado para chaves de endereço [PSAP](https://en.wikipedia.org/wiki/Public_safety_answering_point):

![O mapeamento de um endereço físico para chaves de endereço PSAP.](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/e911-example-mapping-scheme.png)


A tabela a seguir mostra uma lista completa de chaves.


| Nome do atributo | Description | Exemplo | Obrigatório | Limite de caracteres | Limite de caracteres recomendado | 
| --- | --- | --- | --- | --- | --- | 
| país | O país é identificado pelo código ISO 3166 de duas letras. | EUA | Obrigatório | 2 |   | 
| A1 | Subdivisões nacionais (estado, região, província, prefeitura) | NY | Obrigatório | 2 |   | 
| A3 | Cidade, município, shi (JP) | Nova York | Obrigatório | 32 |   | 
| PRD | Principal direção da rua | N, L | Obrigatório somente se aplicável ao endereço | 2 |   | 
| POD | Sufixo da rua traseira | SW | Obrigatório somente se aplicável ao endereço | 2 |   | 
| STS | Sufixo da rua | Avenida, Praça | Obrigatório somente se aplicável ao endereço | 5 |   | 
| HNO | Número da casa (somente parte numérica) | 2121 | Obrigatório | 10 |   | 
| HNS | Sufixo do número da casa | A, 1/2 | Obrigatório somente se aplicável ao endereço | 4 |   | 
| LOC | Informações de localização adicionais | Sala 543 | Opcional | 60 | 20 ou menos | 
| NAM | Nome (residência, empresa ou ocupante do escritório) | Exemplo Corp. | Opcional | 32 |   | 
| PC | CEP | 10027 | Obrigatório | 5 |   | 
| RD | Estrada ou rua principal | Broadway | Obrigatório | 40 |   | 

**nota**  
É sua responsabilidade validar o endereço em um repositório padrão, como o Master Street Address Guide (MSAG).

## Notas de programação
<a name="connect-e911-programming-notes"></a>

Atualmente, não é possível passar uma estrutura JSON como uma `Attribute` para o Amazon Connect. Portanto, a localização recuperada pela função do Lambda precisa ser convertida em uma string JSON antes de ser passada para o Amazon Connect. Por exemplo, usando a linguagem de programação Python, se a localização recuperada for armazenada em uma estrutura JSON, `json_agent_location` poderá ser transmitido para o Amazon Connect (por meio da função do Lambda) da seguinte forma:

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

Para um endereço como o exemplo a seguir:
+ 2121 7th Ave, Seattle, WA, 98.121, USA

O par de chave-valor é:

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

E a string JSON correspondente que é realmente passada para o Amazon Connect:

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

**nota**  
Usar `json.dumps` adiciona um caractere de escape**\\** a cada aspa (**"**).