Method: validateAddress

{
  "revision": integer,
  "regionCode": string,
  "languageCode": string,
  "postalCode": string,
  "sortingCode": string,
  "administrativeArea": string,
  "locality": string,
  "sublocality": string,
  "addressLines": [
    string
  ],
  "recipients": [
    string
  ],
  "organization": string
}

integer

La revisión del esquema de PostalAddress. Cualquier valor diferente de 0 hará que la API muestre un error INVALID_ARGUMENT.

string

Opcional. Código de región de CLDR para el país o la región de la dirección. Para obtener más información, consulta https://cldr.unicode.org/ y https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html. Ejemplo: "CH" para Suiza. Si no se proporciona el código de región, se inferirá de la dirección. Para obtener el mejor rendimiento, se recomienda incluir el código de región si lo conoces. Si hay regiones incoherentes o repetidas, es posible que el rendimiento sea bajo; por ejemplo, si addressLines ya incluye la región, no vuelvas a proporcionar el código regional en este campo. Puede encontrar las regiones admitidas en las Preguntas frecuentes.

string

El código de idioma de la dirección de entrada está reservado para usos futuros y se ignora hoy en día. La API muestra la dirección en el idioma adecuado de su ubicación.

string

Opcional. Código postal de la dirección. No todos los países usan o exigen la presencia de códigos postales, pero en los lugares donde se usan, es posible que activen una validación adicional con otras partes de la dirección (p. ej., validación del código postal o el estado en EE.UU.).

string

Opcional. Código de ordenamiento adicional específico para cada país. No se usa en la mayoría de las regiones. Cuando se utiliza, el valor es una string como "CEDEX", que puede ir seguida de un número (p.ej., "CEDEX 7") o solo un número, que representa el "código de sector" (Jamaica), el "indicador del área de entrega" (Malaui) o el "indicador de correo postal" (p.ej., Costa de Marfil).

string

Opcional. División administrativa más alta que se usa para las direcciones postales de un país o una región. Por ejemplo, puede ser un estado, una provincia, una óblast o una prefectura. En concreto, para España, se trata de la provincia y no la comunidad autónoma (p.ej., "Barcelona" y no "Catalonia"). Muchos países no usan un área administrativa en las direcciones postales. P. ej., en Suiza se dejaría vacío.

string

Opcional. Por lo general, se refiere a la parte de la dirección que indica la ciudad o el pueblo. Ejemplos: ciudad de EE.UU., comuna de Italia o ciudad postal en el Reino Unido. En regiones del mundo donde las localidades no están bien definidas o no coinciden bien con esta estructura, deja la localidad vacía y usa addressLines.

string

Opcional. Sublocalidad de la dirección. Por ejemplo, pueden ser barrios, vecindarios o distritos.

string

Obligatorio. Líneas de dirección no estructuradas que describen los niveles más bajos de una dirección.

Debido a que los valores de addressLines no tienen información de tipo y, en ocasiones, pueden contener varios valores en un solo campo (p.ej., "Austin, TX"), es importante que el orden de las líneas sea claro. El orden de las líneas de dirección debe ser el "orden de sobre" que se usa en el país o la región de la dirección.

La representación estructural mínima permitida de una dirección consiste en toda la información que se coloca en addressLines. Si no se proporciona un regionCode, la región se infiere de las líneas de dirección.

Crear una dirección que solo contenga addressLines y, luego, aplicar codificación geográfica es la manera recomendada de administrar direcciones completamente no estructuradas (en lugar de adivinar qué partes de la dirección deben ser localidades o áreas administrativas).

string

Evite configurar este campo. Actualmente, la API de Address Validation no la usa. Aunque en este momento la API no rechazará las solicitudes con este campo establecido, la información se descartará y no se mostrará en la respuesta.

string

Evite configurar este campo. Actualmente, la API de Address Validation no la usa. Aunque en este momento la API no rechazará las solicitudes con este campo establecido, la información se descartará y no se mostrará en la respuesta.

{
  "verdict": {
    object (Verdict)
  },
  "address": {
    object (Address)
  },
  "geocode": {
    object (Geocode)
  },
  "metadata": {
    object (AddressMetadata)
  },
  "uspsData": {
    object (UspsData)
  }
}

object (Verdict)

Veredictos generales

object (Address)

Información sobre la dirección en sí y no sobre el geocódigo.

object (Geocode)

Información sobre la ubicación y el lugar al que se codificó la dirección.

object (AddressMetadata)

Otra información relevante sobre la entrega. No se garantiza que metadata se propague por completo en cada dirección que se envíe a la API de Address Validation.

object (UspsData)

Marcas de entrega adicionales proporcionadas por USPS. Solo se proporciona en las regiones US y PR.

{
  "inputGranularity": enum (Granularity),
  "validationGranularity": enum (Granularity),
  "geocodeGranularity": enum (Granularity),
  "addressComplete": boolean,
  "hasUnconfirmedComponents": boolean,
  "hasInferredComponents": boolean,
  "hasReplacedComponents": boolean
}

enum (Granularity)

El nivel de detalle de la dirección input. Es el resultado del análisis de la dirección de entrada y no proporciona indicadores de validación. Consulta validationGranularity para obtener más detalles sobre los indicadores de validación.

Por ejemplo, si la dirección de entrada incluye un número de departamento específico, la inputGranularity será SUB_PREMISE. Si no podemos hacer coincidir el número de departamento en las bases de datos o el número de departamento no es válido, es probable que el validationGranularity sea PREMISE o inferior.

enum (Granularity)

Nivel de detalle al que la API puede validar por completo la dirección. Por ejemplo, un validationGranularity de PREMISE indica que se pueden validar todos los componentes de la dirección en el nivel de PREMISE o más generales.

El resultado de la validación del componente por dirección se encuentra en google.maps.addressvalidation.v1.Address.address_components.

enum (Granularity)

Información sobre el nivel de detalle de geocode. Esto se puede interpretar como el significado semántico de qué tan aproximada o precisa es la ubicación geocodificada.

En ocasiones, puede diferir de la validationGranularity anterior. Por ejemplo, nuestra base de datos podría registrar la existencia de un número de apartamento, pero no tener una ubicación precisa para el departamento dentro de un gran complejo de departamentos. En ese caso, el validationGranularity será SUB_PREMISE, pero el geocodeGranularity será PREMISE.

boolean

La dirección se considera completa si no hay tokens sin resolver, no hay componentes de dirección inesperados o faltantes. Consulta los campos missingComponentTypes, unresolvedTokens o unexpected para obtener más detalles.

boolean

Al menos un componente de la dirección no se puede categorizar ni validar. Consulta google.maps.addressvalidation.v1.Address.address_components para obtener más información.

boolean

Se infirió al menos un componente de dirección (se agregó) que no estaba en la entrada. Consulta google.maps.addressvalidation.v1.Address.address_components para obtener más detalles.

boolean

Se reemplazó al menos un componente de dirección. Consulta google.maps.addressvalidation.v1.Address.address_components para obtener más información.

{
  "formattedAddress": string,
  "postalAddress": {
    object (PostalAddress)
  },
  "addressComponents": [
    {
      object (AddressComponent)
    }
  ],
  "missingComponentTypes": [
    string
  ],
  "unconfirmedComponentTypes": [
    string
  ],
  "unresolvedTokens": [
    string
  ]
}

string

La dirección corregida, con formato de una sola línea, según las reglas de formato de dirección de la región donde se encuentra la dirección.

object (PostalAddress)

La dirección validada que se representa como una dirección postal.

object (AddressComponent)

Lista sin ordenar. Los componentes individuales de la dirección con la dirección formateada y corregida, junto con la información de validación. Esto proporciona información sobre el estado de validación de los componentes individuales.

Los componentes de la dirección no están ordenados de una manera en particular. No hagas suposiciones sobre el orden de los componentes de dirección en la lista.

string

Los tipos de componentes que se esperaba que estuvieran presentes en una dirección de correo con el formato correcto, pero no se encontraron en la entrada Y no se pudieron inferir. Los componentes de este tipo no están presentes en formattedAddress, postalAddress ni addressComponents. Un ejemplo podría ser ['street_number', 'route'] para una entrada como "Boulder, Colorado, 80301, EE.UU.". Puede encontrar la lista de tipos posibles aquí.

string

Son los tipos de componentes que están presentes en el addressComponents, pero no se pudo confirmar que sean correctos. Este campo se proporciona para mayor comodidad: su contenido es equivalente a la iteración a través de addressComponents a fin de encontrar los tipos de todos los componentes en los que confirmationLevel no es CONFIRMED o la marca inferred no se establece en true. Puede encontrar la lista de tipos posibles aquí.

string

Cualquier token en la entrada que no se pudo resolver. Puede ser una entrada que no se reconoció como una parte válida de una dirección (por ejemplo, en una entrada como "123235253253 Main St, San Francisco, CA, 94105"), los tokens sin resolver pueden parecer ["123235253253"], ya que no parece un número válido de calle.

{
  "componentName": {
    object (ComponentName)
  },
  "componentType": string,
  "confirmationLevel": enum (ConfirmationLevel),
  "inferred": boolean,
  "spellCorrected": boolean,
  "replaced": boolean,
  "unexpected": boolean
}

object (ComponentName)

El nombre de este componente.

string

El tipo del componente de la dirección. Consulta la Tabla 2: Tipos adicionales que muestra el servicio Places para obtener una lista de los tipos posibles.

enum (ConfirmationLevel)

Indica el nivel de certeza de que el componente es correcto.

boolean

Indica que el componente no era parte de la entrada, pero lo inferimos para la ubicación de la dirección y creemos que debe proporcionarse para una dirección completa.

boolean

Indica que la ortografía del nombre del componente se corrigió de una forma secundaria, por ejemplo, al cambiar dos caracteres que aparecían en el orden incorrecto. Esto indica un cambio estético.

boolean

Indica que el nombre del componente se reemplazó por otro completamente diferente; por ejemplo, si se reemplazó un código postal incorrecto por uno correcto para la dirección. Este no es un cambio estético; el componente de entrada se cambió por uno diferente.

boolean

Indica un componente de dirección que no se espera que esté en una dirección postal para la región dada. Solo la conservamos porque formaba parte de la entrada.

{
  "text": string,
  "languageCode": string
}

string

El texto del nombre. Por ejemplo, "5th Avenue" para el nombre de una calle o "1253" para el número de una calle.

string

El código de idioma BCP-47. Esto no estará presente si el nombre del componente no está asociado a un idioma, como un número de calle.

{
  "location": {
    object (LatLng)
  },
  "plusCode": {
    object (PlusCode)
  },
  "bounds": {
    object (Viewport)
  },
  "featureSizeMeters": number,
  "placeId": string,
  "placeTypes": [
    string
  ]
}

object (LatLng)

La ubicación geográfica de la entrada.

Se prefiere el uso de id. de sitio en lugar de direcciones, coordenadas de latitud y longitud o códigos plus. El uso de coordenadas al calcular o calcular las indicaciones en automóvil siempre implicará el ajuste del punto en la ruta más cercana a dichas coordenadas. Es posible que no sea una ruta que conduzca de forma rápida o segura al destino y que no esté cerca de un access point que dirija a la propiedad. Además, cuando una ubicación tiene codificación geográfica inversa, no hay garantía de que la dirección que se muestre coincida con la original.

object (PlusCode)

El código plus correspondiente al location

object (Viewport)

Los límites del lugar geocodificado.

number

El tamaño del lugar geocodificado en metros. Esta es otra medida del grosor de la ubicación geocodificada, pero en tamaño físico y no en significado semántico.

string

El PlaceID del lugar al que se ingresa este código geográfico.

Para obtener más información sobre los IDs de lugar, consulta este vínculo.

string

Los tipos de sitios a los que se geocodificó la entrada. Por ejemplo, ['locality', 'political']. La lista completa de tipos se puede encontrar aquí.

{
  "latitude": number,
  "longitude": number
}

number

La latitud expresada en grados. Debe pertenecer al rango [-90.0, +90.0].

number

La longitud expresada en grados. Debe pertenecer al rango [-180.0, +180.0].

{
  "globalCode": string,
  "compoundCode": string
}

string

Código global (completa) del lugar, como "9FWM33GV+HQ", que representa un área de 1/8000 por 1/8000 grados (~14 por 14 metros).

string

El código compuesto del lugar, como "33GV+HQ, Ramberg, Noruega", que contiene el sufijo del código global y reemplaza el prefijo con un nombre con formato de una entidad de referencia.

{
  "low": {
    object (LatLng)
  },
  "high": {
    object (LatLng)
  }
}

object (LatLng)

Obligatorio. El punto bajo de la vista del puerto.

object (LatLng)

Obligatorio. El punto alto de la vista del puerto.

{
  "business": boolean,
  "poBox": boolean,
  "residential": boolean
}

boolean

Indica que esta es la dirección de una empresa. Si no se establece, indica que el valor es desconocido.

boolean

Indica que la dirección de un apartado postal. Si no se establece, indica que el valor es desconocido.

boolean

Indica que esta es la dirección de una residencia. Si no se establece, indica que el valor es desconocido.

{
  "standardizedAddress": {
    object (UspsAddress)
  },
  "deliveryPointCode": string,
  "deliveryPointCheckDigit": string,
  "dpvConfirmation": string,
  "dpvFootnote": string,
  "dpvCmra": string,
  "dpvVacant": string,
  "dpvNoStat": string,
  "carrierRoute": string,
  "carrierRouteIndicator": string,
  "ewsNoMatch": boolean,
  "postOfficeCity": string,
  "postOfficeState": string,
  "abbreviatedCity": string,
  "fipsCountyCode": string,
  "county": string,
  "elotNumber": string,
  "elotFlag": string,
  "lacsLinkReturnCode": string,
  "lacsLinkIndicator": string,
  "poBoxOnlyPostalCode": boolean,
  "suitelinkFootnote": string,
  "pmbDesignator": string,
  "pmbNumber": string,
  "addressRecordType": string,
  "defaultAddress": boolean,
  "errorMessage": string,
  "cassProcessed": boolean
}

object (UspsAddress)

Dirección estandarizada del USPS.

string

Código de punto de entrega de 2 dígitos

string

Es el dígito de control del punto de entrega. Este número se agrega al final del código de entrega de punto de barras para los correos electrónicos escaneados de forma mecánica. Si sumas todos los dígitos de delivery_point_barcode, deliveryPointCheckDigit, el código postal y ZIP+4 juntos, el resultado debería ser divisible por 10.

string

Los valores posibles para la confirmación del DPV. Muestra un solo carácter.

• Y: La dirección se confirmó con un DPV para el número principal y el secundario.
• N: No se pudo confirmar la información del DPV sobre el número principal y secundario.
• S: La dirección se confirmó con el DPV solo para el número principal, y la información del número secundario estaba presente, sin confirmar.
• D: Se confirmó la dirección a través del DPV solo para el número principal, y faltaba la información del número secundario.

string

Son las notas al pie de la validación del punto de entrega. Se pueden unir varias notas al pie en la misma string.

• AA: La dirección de entrada coincide con el archivo ZIP+4.
• A1: La dirección de entrada no coincide con el archivo ZIP + 4
• BB: coincide con el DPV (todos los componentes)
• CC: Número secundario no coincidente (presente, pero no válido)
• N1: Falta el número secundario de la dirección de rascacielos
• M1: Falta el número principal
• M3: El número principal no es válido.
• P1: Falta la dirección RR o el número de casilla de ayuda del dispositivo de entrada
• P3: La dirección de entrada, la RR o el número del Centro de ayuda no son válidas
• F1: La dirección de entrada debe coincidir con una dirección militar.
• G1: La dirección de entrada coincide con una dirección de entrega general
• U1: La dirección de entrada coincide con un código postal único.
• PB: La dirección de entrada coincide con el registro de PBSA.
• RR: Dirección confirmada del DPV con información de PMB
• R1: Dirección confirmada de DPV sin información de PMB
• R7: registro R777 o R779 de la empresa de transporte

string

Indica si la dirección es una CMRA (comercio receptora de correo comercial): una empresa privada que recibe correos para clientes. Muestra un solo carácter.

• Y: La dirección es una CMRA.
• N: La dirección no es una CMRA.

string

¿Este lugar está vacante? Muestra un solo carácter.

• Y: La dirección está vacía
• N: La dirección no está vacía.

string

¿La dirección no es estadística o la dirección está activa? Ninguna dirección estadística es aquella que no está ocupada continuamente o que no funciona el USPS. Muestra un solo carácter.

• Y: La dirección no está activa.
• N: La dirección está activa

string

El código de ruta del proveedor. Un código de cuatro caracteres, que consta de un prefijo de una letra y un designador de ruta de tres dígitos.

Prefijos:

• C: Ruta del operador (o ruta de la ciudad)
• R: Ruta rural
• H: Ruta de contrato de autopista
• B: Sección del apartado postal
• G: Unidad de entrega general

string

Indicador de orden de la tarifa de la ruta de transporte,

boolean

La dirección de entrega debe coincidir, pero el archivo EWS indica que una coincidencia exacta estará disponible pronto.

string

Ciudad de oficina postal principal.

string

Estado de la oficina de correo principal

string

Ciudad abreviada

string

Código de condado del FIPS.

string

Nombre del condado.

string

Número de línea de viaje mejorada (eLOT)

string

eLOT Ascendente/Descendente (A/D).

string

Código de retorno LACSLink

string

Indicador LACSLink.

boolean

Código postal solo para el apartado postal.

string

Notas a pie de página que coinciden con la calle o un registro de rascacielos para la información de la suite. Si se encuentra la coincidencia del nombre de la empresa, se mostrará el número secundario.

• A: Se mejoró la coincidencia de registros de SuiteLink y se mejoró la dirección de la empresa.
• 00: No hay coincidencia, no se mejoró la dirección de la empresa.

string

Designador de unidad de PMB (buzón de correo privado).

string

Número de PMB (buzón de correo privado)

string

Tipo de registro de dirección que coincide con la dirección de entrada.

• F: FIRM. Esta es una coincidencia con un registro de empresa, que es el mejor nivel de coincidencia disponible para una dirección.
• G: ENTREGA GENERAL. Esta información coincide con un registro de publicación general.
• H: EDICIÓN / DEPARTAMENTO Esta es una coincidencia con el registro de un edificio o departamento.
• P: CAJA POSTAL. Esta corresponde a una casilla postal.
• R: RUTA RURAL o CONTRATO PARA ALTAS LUGARES: Esta es una coincidencia con una ruta rural o un registro de contrato de autopista, que pueden tener rangos de números de caja asociados.
• S: STREET RECORD: Es una coincidencia con un registro de Street View que contiene un rango de números primarios válido.

boolean

Indicador de que se encontró una dirección predeterminada, pero existen direcciones más específicas.

string

Mensaje de error para la recuperación de datos del USPS. Esto se propaga cuando se suspende el procesamiento de USPS debido a la detección de direcciones creadas de forma artificial.

Es posible que los campos de datos del USPS no se propaguen cuando se produce este error.

boolean

Indicador de que la solicitud se procesó mediante CASS.

{
  "firstAddressLine": string,
  "firm": string,
  "secondAddressLine": string,
  "urbanization": string,
  "cityStateZipAddressLine": string,
  "city": string,
  "state": string,
  "zipCode": string,
  "zipCodeExtension": string
}

string

Primera línea de dirección.

string

Nombre de empresa.

string

Segunda línea de dirección.

string

Nombre de la urbanización puertorriqueña.

string

Ciudad + estado + código postal

string

Nombre de la ciudad.

string

Código de estado de 2 letras.

string

Código postal, p.ej. 10009.

string

Extensión de código postal de 4 dígitos, p.ej., 5023.