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 distinto 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, te recomendamos que incluyas el código de región (si lo conoces). Tener regiones incoherentes o repetidas puede generar un rendimiento deficiente. Por ejemplo, si addressLines ya incluye la región, no vuelvas a proporcionar el código regional en este campo. Consulta las Preguntas frecuentes para conocer las regiones admitidas.

string

El código de idioma de la dirección de entrada se reserva para usos futuros y se ignora hoy. La API muestra la dirección en el idioma adecuado en el que se encuentra.

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 usa, el valor es una string como "CEDEX", opcionalmente seguida de un número (p.ej., "CEDEX 7") o solo un número, que representa el "código del sector" (Jamaica), el "indicador del área de entrega" (Malaui) o el "indicador de oficina de correo" (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. Específicamente, en España se trata de la provincia y no la comunidad autónoma (p.ej., "Barcelona" y no "Cataluña"). 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, a veces, 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, realizar la geocodificación es la forma recomendada de manejar direcciones sin estructura alguna (en lugar de adivinar qué partes de la dirección deben ser localidades o áreas administrativas).

string

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

string

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

{
  "returnEnglishLatinAddress": boolean
}

boolean

Vista previa: Muestra un google.maps.addressvalidation.v1.Address en inglés. Consulta google.maps.addressvalidation.v1.ValidationResult.english_latin_address para obtener información.

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

object (Verdict)

Marcas de veredicto general

object (Address)

Incluye información sobre la dirección en sí, a diferencia del geocódigo.

object (Geocode)

Información sobre la ubicación y el lugar a los que se geocodifica la dirección.

object (AddressMetadata)

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

object (UspsData)

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

object (Address)

Versión preliminar: Esta función se encuentra en versión preliminar (fase previa a la DG). Los productos y las funciones que se encuentran en la fase previa a la DG pueden tener asistencia limitada, y los cambios en estos productos y funciones podrían no ser compatibles con otras versiones de la fase previa a la DG. Las ofertas que se encuentran en la fase previa a la DG están cubiertas por las Condiciones Específicas del Servicio de Google Maps Platform. Para obtener más información, consulta las descripciones de la etapa de lanzamiento.

La dirección se tradujo al inglés. Si una parte de la dirección no tiene traducción al inglés, el servicio muestra esa parte en un idioma alternativo que utilice la escritura latina. Consulta aquí una explicación sobre cómo se selecciona el idioma alternativo. Si una parte de la dirección no tiene traducciones ni transliteraciones en un idioma que utiliza un alfabeto latino, el servicio muestra esa parte en el idioma local asociado a la dirección.

Habilitaste este resultado con la marca google.maps.addressvalidation.v1.LanguageOptions.return_english_latin_address.

Nota: Los campos google.maps.addressvalidation.v1.Address.unconfirmed_component_types en englishLatinAddress y google.maps.addressvalidation.v1.AddressComponent.confirmation_level en englishLatinAddress.address_components no se propagan.

{
  "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. Este es el resultado del análisis de la dirección de entrada y no proporciona ninguna señal de validación. Para conocer los indicadores de validación, consulta validationGranularity a continuación.

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

enum (Granularity)

El nivel de detalle con el 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 dirección en el nivel de PREMISE o más valores generales.

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

enum (Granularity)

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

En ocasiones, esto puede diferir de la validationGranularity anterior. Por ejemplo, es posible que nuestra base de datos registre la existencia de un número de departamento, pero que no tenga una ubicación precisa del departamento dentro de un complejo grande 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 ni 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 o validar. Consulta google.maps.addressvalidation.v1.Address.address_components para obtener más información.

boolean

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

boolean

Se reemplazó al menos un componente de la dirección. Para obtener más información, consulta google.maps.addressvalidation.v1.Address.address_components.

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

string

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

object (PostalAddress)

La dirección después del procesamiento representada como una dirección postal.

object (AddressComponent)

Lista sin ordenar. Los componentes individuales de la dirección con formato y la corrección 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 dirección no están ordenados de manera particular. No hagas suposiciones sobre el orden de los componentes de dirección en la lista.

string

Los tipos de componentes que se esperaban presentes en una dirección de correo con el formato correcto, pero que 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.”. La lista de tipos posibles se encuentra aquí.

string

Los tipos de componentes que están presentes en addressComponents, pero que no se pudo confirmar como correctos Este campo se proporciona para mayor comodidad: su contenido es equivalente a iterar a través de addressComponents para encontrar los tipos de todos los componentes en los que confirmationLevel no es CONFIRMED o en los que la marca inferred no está configurada en true. La lista de tipos posibles se encuentra aquí.

string

Cualquier token en la entrada que no se pudo resolver. Puede tratarse de 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 tener el siguiente aspecto: ["123235253253"], ya que no parece un número de calle válido.

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

object (ComponentName)

Es 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 que tenemos 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 debería proporcionarse para una dirección completa.

boolean

Indica una corrección de una falta de ortografía en el nombre del componente. La API no siempre marca los cambios de una variante ortográfica a otra, como cuando cambia “centre” a “center”. Tampoco siempre se marcan los errores ortográficos comunes, como cuando se cambia "Amphitheater Pkwy" a "Amphitheatre Pkwy".

boolean

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

boolean

Indica un componente de dirección que no se espera que esté presente en una dirección postal de la región determinada. Lo retenemos solo porque era parte de la entrada.

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

string

Es el texto del nombre. Por ejemplo, "Quinta Avenida" para el nombre de la calle o "1253" para el número de la calle.

string

Es el código de idioma BCP-47. 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)

Es la ubicación geocodificada de la entrada.

Es preferible usar IDs de lugar en lugar de direcciones, coordenadas de latitud y longitud o Plus Codes. El uso de coordenadas al trazar o calcular rutas en auto siempre hará que el punto se acople a la ruta más cercana a esas coordenadas. Es posible que esta no sea una ruta que lleve al destino de forma rápida o segura y que no esté cerca de un punto de acceso a la propiedad. A su vez, cuando una ubicación se somete a geocodificación inversa, no hay garantía de que la dirección devuelta coincida con la original.

object (PlusCode)

El Plus Code correspondiente al location.

object (Viewport)

Los límites del lugar geocodificado.

number

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

string

El PlaceID del lugar al que se geocodifica esta entrada.

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

string

Los tipos de sitios a los que se geocodifica la entrada. Por ejemplo, ['locality', 'political']. Puede encontrar la lista completa de tipos 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 (completo) del lugar, como "9FWM33GV+HQ", que representa un área de 1/8000 por 1/8000 grados (~14 por 14 metros).

string

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

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

object (LatLng)

Obligatorio. Punto bajo del viewport

object (LatLng)

Obligatorio. El punto alto del viewport.

{
  "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 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 barras delivery_point_barcode para el correo electrónico analizado de forma mecánica. Si agregas todos los dígitos de delivery_point_barcode, deliveryPointCheckDigit, código postal y ZIP+4, deberías obtener un número divisible por 10.

string

Son los valores posibles para la confirmación de DPV. Muestra un solo carácter.

• Y: Se confirmó la dirección DPV para los números principales y secundarios.
• N: No se pudo confirmar la información del número principal ni el secundario.
• S: Se confirmó la dirección solo para el número principal y la información del número secundario estaba presente, pero no se confirmó.
• D: Se confirmó la dirección solo para el número principal y faltaba la información del número secundario.

string

Las notas al pie de la validación del punto de entrega. Es posible que varias notas al pie estén juntas 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 DPV (todos los componentes)
• CC: Número secundario no coincidente (presente, pero no válido)
• N1: Falta el número secundario en la dirección de gran altura
• M1: Falta el número principal
• M3: Número principal no válido
• P1: Falta el número de casilla de la dirección de entrada RR o del Centro de ayuda
• P3: El número de la orden de compra de la dirección de entrada, RR o HC no es válido.
• F1: La dirección de entrada coincide 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 PBSA.
• RR: DPV confirmó una dirección con información de PMB
• R1: Dirección confirmada por DPV sin información de PMB
• R7: registro de la ruta R777 o R779 del proveedor

string

Indica si la dirección es una CMRA (agencia de recepción de correo comercial), una empresa privada que recibe correo para los clientes. Muestra un solo carácter.

• Y: La dirección corresponde a una CMRA
• N: La dirección no pertenece a la CMRA

string

¿Está vacante este lugar? Muestra un solo carácter.

• Y: La dirección está vacante
• N: La dirección no está vacante

string

¿Es una dirección sin estadísticas o una dirección activa? Ninguna dirección estadística es aquella que no se ocupa continuamente o que no brinda el servicio USPS. Muestra un solo carácter.

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

string

Es el código de ruta de la empresa de transporte. Es 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 de la empresa de transporte (o ruta de la ciudad)
• R: Ruta rural
• H: Ruta de contrato de autopista
• B: Sección de apartado postal
• G: Unidad de entrega general

string

Indicador de orden de tarifa de la ruta de la empresa de transporte.

boolean

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

string

Ciudad principal de la oficina de correos.

string

Estado principal de la oficina de correos

string

Ciudad abreviada.

string

Código del 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 devolución de LACSLink.

string

Indicador de vínculo de LACS.

boolean

Código postal solo para apartado postal.

string

Notas al pie que van desde hacer coincidir el registro de una calle o rascacielos con información de un paquete. Si el nombre de la empresa coincide, se muestra el número secundario.

• A: Coincidencia del registro de SuiteLink; se mejoró la dirección de la empresa.
• 00: Sin coincidencia, no se mejoró la dirección de la empresa.

string

Designador de unidades de PMB (buzón privado).

string

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

string

El tipo de registro de dirección que coincide con la dirección de entrada.

• F: FIRM. Esto coincide con un registro de la empresa, que es el mejor nivel de coincidencia disponible para una dirección.
• G: ENTREGA GENERAL. Esto coincide con un registro de entrega general.
• H: EDICIÓN O Departamento. Esto coincide con un registro de edificio o departamento.
• P: RECURSO DE OFICINA. Esto coincide con un apartado postal.
• R: CONTRATO DE RUTA RURAL o CARTERA: Es una coincidencia con un registro de ruta rural o contrato de autopista, que pueden tener rangos de números de casilla asociados.
• S: STREET RECORD: Es una coincidencia con un registro de Street Record 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. Se propaga cuando se suspende el procesamiento de la USPS debido a la detección de direcciones creadas de forma artificial.

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

boolean

Indicador de que se procesó la solicitud de 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 la 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.