Chime / Client / validate_e911_address

validate_e911_address

Chime.Client.validate_e911_address(**kwargs)

Validates an address to be used for 911 calls made with Amazon Chime Voice Connectors. You can use validated addresses in a Presence Information Data Format Location Object file that you include in SIP requests. That helps ensure that addresses are routed to the appropriate Public Safety Answering Point.

See also: AWS API Documentation

Request Syntax

response = client.validate_e911_address(
    AwsAccountId='string',
    StreetNumber='string',
    StreetInfo='string',
    City='string',
    State='string',
    Country='string',
    PostalCode='string'
)

Parameters:

• AwsAccountId (string) –

  [REQUIRED]

  The AWS account ID.

• StreetNumber (string) –

  [REQUIRED]

  The address street number, such as 200 or 2121.

• StreetInfo (string) –

  [REQUIRED]

  The address street information, such as 8th Avenue.

• City (string) –

  [REQUIRED]

  The address city, such as Portland.

• State (string) –

  [REQUIRED]

  The address state, such as ME.

• Country (string) –

  [REQUIRED]

  The address country, such as US.

• PostalCode (string) –

  [REQUIRED]

  The address postal code, such as 04352.

Return type:

dict

Returns:

Response Syntax

{
    'ValidationResult': 123,
    'AddressExternalId': 'string',
    'Address': {
        'streetName': 'string',
        'streetSuffix': 'string',
        'postDirectional': 'string',
        'preDirectional': 'string',
        'streetNumber': 'string',
        'city': 'string',
        'state': 'string',
        'postalCode': 'string',
        'postalCodePlus4': 'string',
        'country': 'string'
    },
    'CandidateAddressList': [
        {
            'streetInfo': 'string',
            'streetNumber': 'string',
            'city': 'string',
            'state': 'string',
            'postalCode': 'string',
            'postalCodePlus4': 'string',
            'country': 'string'
        },
    ]
}

Response Structure

• (dict) –

  • ValidationResult (integer) –

    Number indicating the result of address validation. 0 means the address was perfect as is and successfully validated. 1 means the address was corrected. 2 means the address sent was not close enough and was not validated.

  • AddressExternalId (string) –

    The ID that represents the address.

  • Address (dict) –

    The validated address.

    • streetName (string) –

      The address street, such as 8th Avenue.

    • streetSuffix (string) –

      The address suffix, such as the N in 8th Avenue N.

    • postDirectional (string) –

      An address suffix location, such as the S. Unit A in Central Park S. Unit A.

    • preDirectional (string) –

      An address prefix location, such as the N in N. Third St..

    • streetNumber (string) –

      The numeric portion of an address.

    • city (string) –

      The city of an address.

    • state (string) –

      The state of an address.

    • postalCode (string) –

      The postal code of an address.

    • postalCodePlus4 (string) –

      The Zip + 4 or postal code + 4 of an address.

    • country (string) –

      The country of an address.

  • CandidateAddressList (list) –

    The list of address suggestions.

    • (dict) –

      A suggested address.

      • streetInfo (string) –

        The street information of a candidate address

      • streetNumber (string) –

        The numeric portion of a candidate address.

      • city (string) –

        The city of a candidate address.

      • state (string) –

        The state of a candidate address.

      • postalCode (string) –

        The postal code of a candidate address.

      • postalCodePlus4 (string) –

        The Zip + 4 or postal code + 4 of a candidate address.

      • country (string) –

        The country of a candidate address.

Exceptions

• Chime.Client.exceptions.UnauthorizedClientException

• Chime.Client.exceptions.NotFoundException

• Chime.Client.exceptions.ForbiddenException

• Chime.Client.exceptions.BadRequestException

• Chime.Client.exceptions.ThrottledClientException

• Chime.Client.exceptions.ServiceUnavailableException

• Chime.Client.exceptions.ServiceFailureException