Mise en forme d’une adresse physique à passer à Amazon Connect via le E911
Cette rubrique explique comment mettre en forme une adresse physique afin qu'elle puisse être transmise à Amazon Connect.
Les appels sortants E911 nécessitent qu'une adresse physique soit transmise à Amazon Connect sous forme de chaîne JSON avec des clés et des valeurs qui représentent les différents champs de l'adresse. Prenons l'exemple d'adresse suivant aux États-Unis :
-
2121 7th Ave, Seattle, WA, 98121, USA
L'adresse doit être attachée sous forme de chaîne JSON à la clé CivicAddress, comme illustré dans l'exemple suivant. Chaque champ d'adresse est associé à une clé codée spécifique.
CivicAddress:
{"country":"USA","RD":"7th","A3":"Seattle","PC":"98121","HNO":"2121","STS":"Ave","A1":"WA"}
L'illustration suivante montre comment un exemple d'adresse en entrée est mappé aux clés d'adresse PSAP
Le tableau suivant présente une liste complète de clés.
| Nom d'attribut | Description | Exemple | Obligatoire | Limite de caractères | Limite de caractères recommandée |
|---|---|---|---|---|---|
|
country |
Le pays est identifié par le code ISO 3166 à deux lettres. |
ETATS-UNIS |
Obligatoire |
2 |
|
|
R1 |
Subdivisions nationales (état, région, province, préfecture) |
NY |
Obligatoire |
2 |
|
|
R3 |
Ville, commune, shi (JP) |
New York |
Obligatoire |
32 |
|
|
PRD |
Sens de la rue de début |
N, W |
Obligatoire uniquement si applicable à l'adresse |
2 |
|
|
POD |
Suffixe de la rue de fin |
SW |
Obligatoire uniquement si applicable à l'adresse |
2 |
|
|
STS |
Suffixe de rue |
Avenue, Platz |
Obligatoire uniquement si applicable à l'adresse |
5 |
|
|
HNO |
Numéro de maison (partie numérique uniquement) |
2 121 |
Obligatoire |
10 |
|
|
HNS |
Suffixe du numéro de maison |
A, 1/2 |
Obligatoire uniquement si applicable à l'adresse |
4 |
|
|
LOC |
Informations de localisation supplémentaires |
Chambre 543 |
Facultatif |
60 |
20 ou moins |
|
NAM |
Nom (occupant de résidence, d'entreprise ou de bureau) |
Exemple d'entreprise |
Facultatif |
32 |
|
|
PC |
Code postal |
10027 |
Obligatoire |
5 |
|
|
RD |
Route ou rue principale |
Broadway |
Obligatoire |
40 |
Note
Il vous incombe de valider l'adresse par rapport à un référentiel standard tel que le Master Street Address Guide (MSAG).
Notes de programmation
Il n'est actuellement pas possible de transmettre une structure JSON en tant que paramètre Attribute à Amazon Connect. Par conséquent, l'emplacement récupéré par la fonction Lambda doit être converti en chaîne JSON avant d'être transmis à Amazon Connect. Par exemple, en utilisant le langage de programmation Python, si l'emplacement récupéré est enregistré dans une structure JSON json_agent_location, il peut être transmis à Amazon Connect (à partir de la fonction Lambda) comme suit :
return { ,'CivicAddress': json.dumps(json_agent_location) ,'agent_did_number':
'+15555551212' }
Pour une adresse semblable à l'exemple suivant :
-
2121 7th Ave, Seattle, WA, 98121, USA
La paire clé/valeur :
CivicAddress: {"country": "USA", "RD":
"7th", "A3":
"Seattle", "PC":
"98121", "HNO":
"2121", "STS":
"Ave", "A1":
"WA"}
Et la chaîne JSON correspondante qui est effectivement transmise à Amazon Connect :
CivicAddress: {\"country\": \"USA\", \"RD\":
\"7th\", \"A3"\:
\"Seattle\", \"PC\":
\"98121\", \"HNO\":
\"2121\", \"STS\":
\"Ave\", \"A1\":
\"WA\"}
Note
L'utilisation de json.dumps ajoute un caractère d'échappement \ à chaque guillemet (").
