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