Package google.maps.addressvalidation.v1

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

string

Es la dirección procesada posteriormente, con el formato de una sola línea y que sigue las reglas de formato de la región en la que se encuentra.

Nota: Es posible que el formato de esta dirección no coincida con el formato de la dirección en el campo postal_address. Por ejemplo, el postal_address siempre representa el país como un region_code de 2 letras, como "US" o "NZ". Por el contrario, este campo usa una forma más larga del nombre del país, como “EE.UU.” o “Nueva Zelanda”.

PostalAddress

Es la dirección procesada después, representada como una dirección postal.

AddressComponent

Lista sin ordenar. Los componentes individuales de la dirección corregida y con formato, 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 la dirección en la lista.

string

Son los tipos de componentes que se esperaban que estuvieran presentes en una dirección de correo con el formato correcto, pero que no se encontraron en la entrada Y que no se pudieron inferir. Un ejemplo podría ser ['street_number', 'route'] para una entrada como "Boulder, Colorado, 80301, EE.UU.". Puedes encontrar la lista de tipos posibles aquí.

Nota: Es posible que veas un tipo de componente faltante cuando creas que ya lo proporcionaste. Por ejemplo, esto puede ocurrir cuando la dirección de entrada contiene el nombre del edificio, pero no el número de la propiedad. En la dirección "渋谷区渋谷３丁目　Shibuya Stream", el nombre del edificio "Shibuya Stream" tiene el tipo de componente premise, pero falta el número de la propiedad, por lo que missing_component_types contendrá premise.

string

Son los tipos de componentes que están presentes en address_components, pero que no se pudo confirmar que sean correctos. Este campo se proporciona por motivos de conveniencia: su contenido equivale a iterar por address_components para encontrar los tipos de todos los componentes en los que confirmation_level no es CONFIRMED o la marca inferred no está establecida en true. Puedes encontrar la lista de tipos posibles aquí.

string

Cualquier token de la entrada que no se pudo resolver Puede ser una entrada que no se reconoció como parte válida de una dirección. Por ejemplo, para una entrada como "Parcel 0000123123 & 0000456456 Str # Guthrie Center IA 50115 US", los tokens no resueltos podrían verse como ["Parcel", "0000123123", "&", "0000456456"].

ComponentName

Es el nombre de este componente.

string

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

ConfirmationLevel

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

bool

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

bool

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

bool

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

bool

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

bool

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

bool

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

bool

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

string

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

string

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

LatLng

Es la ubicación geocodificada de la entrada.

Se prefiere usar los IDs de lugar en lugar de direcciones, coordenadas de latitud y longitud o códigos plus. El uso de coordenadas cuando se planifican rutas o se calculan instrucciones sobre cómo llegar siempre hará que el punto se ajuste a la ruta más cercana a esas coordenadas. Es posible que no sea una ruta que te lleve al destino de forma rápida o segura, y que no esté cerca de un punto de acceso a la propiedad. Además, cuando se codifica geográficamente una ubicación de forma inversa, no hay garantía de que la dirección que se muestra coincida con la original.

PlusCode

El Plus Code correspondiente al location.

Viewport

Los límites del lugar geocodificado

float

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

string

El PlaceID del lugar al que geocodifica esta entrada.

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

string

Los tipos de lugares a los que se geocodió la entrada. Por ejemplo, ['locality', 'political']. Puedes encontrar la lista completa de tipos aquí.

bool

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.

string

Es el código global (completo) del lugar, como "9FWM33GV+HQ", que representa un área de 1/8,000 por 1/8,000 de grado (~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 por un nombre con formato de una entidad de referencia

ValidationConclusion

Es obligatorio. El resultado de la secuencia de intentos de validación.

Si este campo se establece en VALIDATION_CONCLUSION_UNSPECIFIED, se mostrará un error INVALID_ARGUMENT.

string

Es obligatorio. Es el ID de la respuesta para la que se escribieron estos comentarios. Debe ser el [response_id][google.maps.addressvalidation.v1.ValidateAddressRequest.response_id] de la primera respuesta en una serie de intentos de validación de direcciones.

string

Primera línea de dirección.

string

Nombre de la empresa.

string

Segunda línea de la dirección.

string

Nombre de la urbanización de Puerto Rico.

string

Ciudad, estado y código postal

string

Nombre de la ciudad.

string

Es un 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.

UspsAddress

Dirección estandarizada del USPS.

string

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

string

El dígito de control del punto de entrega Este número se agrega al final del código de barras de delivery_point para el correo escaneado mecánicamente. Si sumas todos los dígitos de delivery_point_barcode, delivery_point_check_digit, postal_code 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 o no muestra ningún valor.

• N: No se pudo confirmar la información del número principal ni de los números secundarios en DPV.
• D: La dirección se confirmó como DPV solo para el número principal y faltaba la información del número secundario.
• S: La dirección se confirmó como DPV solo para el número principal, y la información del número secundario estaba presente, pero no se confirmó.
• Y: La dirección se confirmó como DPV para los números principales y secundarios.
• Vacío: Si la respuesta no contiene un valor dpv_confirmation, significa que la dirección no se envió para la confirmación de DPV.

string

Las notas al pie de la validación del punto de entrega Se pueden unir varias notas al pie en la misma cadena.

• AA: Dirección de entrada que 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: El número secundario no coincide y no es obligatorio.
• C1: El número secundario no coincide, pero es obligatorio.
• N1: Falta el número secundario en la dirección de un edificio alto.
• M1: Falta el número principal
• M3: El número principal no es válido
• P1: Falta el número de apartado postal, RR o HC de la dirección de entrada.
• P3: El número de apartado postal, RR o HC de la dirección de entrada 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 de PBSA
• RR: Dirección confirmada por el DPV con información del PMB
• R1: Dirección confirmada por DPV sin información de PMB
• R7: Es el registro R777 o R779 de la ruta del operador.
• IA: Se identificó la dirección informada
• TA: Número principal que coincide con la eliminación de una letra alfa al final

string

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

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

string

¿Está disponible 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? Las direcciones sin estadísticas son aquellas que no están ocupadas de forma continua o que el USPS no entrega. Muestra un solo carácter.

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

int32

Indica el tipo de NoStat. Muestra un código de motivo como int.

• 1: IDA (dirección de entrega interna): Son direcciones que no reciben correo directamente del USPS, sino que se entregan a una dirección de entrega que las atiende.
• 2: CDS: Son las direcciones que aún no se pueden entregar. Por ejemplo, una nueva subdivisión en la que se determinaron los lotes y los números principales, pero aún no existe una estructura para la ocupación.
• 3: Colisión: Son direcciones que en realidad no confirman la DPV.
• 4: CMZ (colegios, instituciones militares y otros tipos): código postal + 4 registros que USPS incorporó a los datos.
• 5: Normal: Indica que las direcciones no reciben entregas y que no se cuentan como posibles entregas.
• 6: Secundario obligatorio: La dirección requiere información secundaria.

string

La marca indica que el correo se entrega a un solo receptáculo en un sitio. Muestra un solo carácter.

• Y: El correo se entrega a un solo receptáculo en un sitio.
• N: El correo no se entrega a un solo receptáculo en un sitio.

string

Indica que el correo no se entrega en la dirección. Muestra un solo carácter.

• Y: El correo no se entrega en la dirección.
• N: El correo se entrega a la dirección.

string

La marca indica que la entrega de correo no se realiza todos los días de la semana. Muestra un solo carácter.

• Y: La entrega de correo no se realiza todos los días de la semana.
• N: No hay indicios de que la entrega de correo no se realice todos los días de la semana.

int32

Es un número entero que identifica los días en los que no se realizó la publicación. Se puede interrogar con marcas de bits: 0x40: El domingo es un día sin entrega. 0x20: El lunes es un día sin entrega. 0x10: El martes es un día sin entrega. 0x08: El miércoles es un día sin entrega. 0x04: El jueves es un día sin entrega. 0x02: El viernes es un día sin entrega. 0x01: El sábado es un día sin entrega.

string

La marca indica que se puede acceder a la puerta, pero no se dejará el paquete debido a problemas de seguridad. Muestra un solo carácter.

• Y: No se dejará el paquete debido a problemas de seguridad.
• N: No hay indicios de que no se dejará el paquete debido a problemas de seguridad.

string

Indica que la dirección coincide con el registro de PBSA. Muestra un solo carácter.

• Y: La dirección coincidió con el registro de PBSA.
• N: La dirección no coincide con el registro de PBSA.

string

La marca indica las direcciones en las que el USPS no puede tocar la puerta para entregar el correo. Muestra un solo carácter.

• Y: No se puede acceder a la puerta.
• N: No hay indicaciones de que no se puede acceder a la puerta.

string

Indica que más de un código de devolución de DPV es válido para la dirección. Muestra un solo carácter.

• Y: La dirección se confirmó como DPV para los números principales y secundarios.
• N: No se pudo confirmar la información del número principal ni de los números secundarios en DPV.
• S: La dirección se confirmó como DPV solo para el número principal, y la información del número secundario estaba presente, pero no se confirmó, o se omitió una sola letra alfa al final de un número principal para que coincida con la información secundaria y se requiera.
• D: La dirección se confirmó como DPV solo para el número principal y faltaba la información del número secundario.
• R: Se confirmó la dirección, pero se asignó a las rutas fantasmas R777 y R779, y no se proporcionó la entrega del USPS.

string

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

string

Indicador de clasificación de tarifas de ruta de la empresa de transporte.

bool

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

string

Ciudad de la oficina de correos principal

string

Estado de la oficina postal principal.

string

Es la ciudad abreviada.

string

Código de condado del FIPS.

string

Es el nombre del condado.

string

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

string

Marca ascendente o descendente de eLOT (A/D).

string

Código de retorno de LACSLink.

string

Indicador de LACSLink.

bool

Código postal solo para apartados postales

string

Notas al pie de coincidencia de un registro de calle o rascacielos con la información de un departamento. Si se encuentra una coincidencia con el nombre de la empresa, se muestra el número secundario.

• A: Coincidencia de registros de SuiteLink, dirección de la empresa mejorada.
• 00: No hay coincidencias, la dirección de la empresa no se mejora.

string

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

string

Número de PMB (buzón privado)

string

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

• F: FIRM. Es una coincidencia con un registro de empresa, que es el nivel de coincidencia más preciso disponible para una dirección.
• G: PUBLICACIÓN GENERAL. Es una coincidencia con un registro de entrega general.
• H: EDIFICIO O APARTAMENTO Es una coincidencia con un registro de edificio o departamento.
• P: BUZON POSTAL. Es una coincidencia con un apartado postal.
• R: RURAL ROUTE o HIGHWAY CONTRACT: Es una coincidencia con un registro de ruta rural o de contrato de autopista, que pueden tener rangos de números de buzón asociados.
• S: REGISTRO DE CALLE: Es una coincidencia con un registro de calle que contiene un rango de números primarios válido.

bool

Indica 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. Este valor se propaga cuando se suspende el procesamiento del 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 presente este error.

bool

Es un indicador de que la solicitud se procesó según el CASS.

PostalAddress

Es obligatorio. La dirección que se está validando. Las direcciones sin formato se deben enviar a través de address_lines.

La longitud total de los campos de esta entrada no debe exceder los 280 caracteres.

Puedes encontrar las regiones admitidas aquí.

El valor language_code en la dirección de entrada se reserva para usos futuros y se ignora en la actualidad. El resultado de la dirección validada se propagará según el idioma preferido para la dirección determinada, según lo identifique el sistema.

La API de Address Validation ignora los valores de recipients y organization. Cualquier valor en esos campos se descartará y no se mostrará. No los configures.

string

Este campo debe estar vacío para la primera solicitud de validación de dirección. Si se necesitan más solicitudes para validar completamente una sola dirección (por ejemplo, si los cambios que realiza el usuario después de la validación inicial deben volver a validarse), cada solicitud de seguimiento debe propagar este campo con el response_id de la primera respuesta en la secuencia de validación.

bool

Habilita el modo compatible con CASS de USPS. Esto afecta solo al campo google.maps.addressvalidation.v1.ValidationResult.usps_data de google.maps.addressvalidation.v1.ValidationResult. Nota: Para las solicitudes habilitadas por el CASS del USPS para direcciones de Puerto Rico, se debe proporcionar un google.type.PostalAddress.region_code de address como "PR" o un google.type.PostalAddress.administrative_area de address como "Puerto Rico" (sin distinción entre mayúsculas y minúsculas) o "PR".

Se recomienda usar un address con componentes o, como alternativa, especificar al menos dos google.type.PostalAddress.address_lines en los que la primera línea contenga el número y el nombre de la calle, y la segunda línea contenga la ciudad, el estado y el código postal.

LanguageOptions

Opcional. Versión preliminar: Esta función está 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 se rigen 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.

Permite que la API de Address Validation incluya información adicional en la respuesta.

string

Opcional. Es una cadena que identifica una sesión de Autocomplete para realizar la facturación correspondiente. Debe ser una cadena base64 segura para la URL y el nombre de archivo con una longitud máxima de 36 caracteres ASCII. De lo contrario, se muestra un error INVALID_ARGUMENT.

La sesión comienza cuando el usuario realiza una consulta de Autocomplete y termina cuando selecciona un lugar y se realiza una llamada a Place Details o Address Validation. Cada sesión puede tener varias búsquedas de Autocomplete, seguidas de una solicitud de Place Details o Address Validation. Las credenciales que se usan para cada solicitud dentro de una sesión deben pertenecer al mismo proyecto de la consola de Google Cloud. Una vez que finaliza la sesión, el token deja de ser válido. Tu app debe generar un token nuevo para cada sesión. Si se omite el parámetro sessionToken, o si reutilizas un token de sesión, la sesión se cobrará como si no se hubiera proporcionado un token de sesión (cada solicitud se factura por separado).

Nota: Address Validation solo se puede usar en sesiones con la API de Autocomplete (nueva), no con la API de Autocomplete. Consulta https://developers.google.com/maps/documentation/places/web-service/session-pricing para obtener más información.

ValidationResult

Es el resultado de la validación de la dirección.

string

Es el UUID que identifica esta respuesta. Si la dirección debe volver a validarse, este UUID debe acompañar a la solicitud nueva.

Verdict

Marcas de veredicto general

Address

Es la información sobre la dirección en sí, en lugar del código geográfico.

Geocode

Es la información sobre la ubicación y el lugar al que se geocodificó la dirección.

AddressMetadata

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

UspsData

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

Address

Versión preliminar: Esta función está 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 se rigen 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 traducida al inglés.

Las direcciones traducidas no se pueden volver a usar como entrada de la API. El servicio las proporciona para que el usuario pueda usar su idioma nativo y confirmar o rechazar la validación de la dirección proporcionada originalmente.

Si parte de la dirección no tiene una traducción al inglés, el servicio muestra esa parte en un idioma alternativo que usa una escritura latina. Consulta este vínculo para obtener una explicación sobre cómo se selecciona el idioma alternativo. Si parte de la dirección no tiene traducciones ni transliteraciones en un idioma que usa un alfabeto latino, el servicio muestra esa parte en el idioma local asociado con la dirección.

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

Nota: No se propagan los campos google.maps.addressvalidation.v1.Address.unconfirmed_component_types en english_latin_address ni los campos google.maps.addressvalidation.v1.AddressComponent.confirmation_level en english_latin_address.address_components.

Granularity

El nivel de detalle de la dirección de entrada. Este es el resultado del análisis de la dirección de entrada y no proporciona ningún indicador de validación. Para obtener información sobre los indicadores de validación, consulta validation_granularity a continuación.

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

Granularity

Es el nivel de detalle hasta el que la API puede validar la dirección. Por ejemplo, un validation_granularity de PREMISE indica que se pueden validar todos los componentes de dirección a nivel de PREMISE o más detallados.

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

Granularity

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

En ocasiones, puede diferir del validation_granularity anterior. Por ejemplo, nuestra base de datos puede registrar la existencia de un número de departamento, pero no tiene una ubicación precisa para el departamento dentro de un gran complejo de departamentos. En ese caso, validation_granularity será SUB_PREMISE, pero geocode_granularity será PREMISE.

bool

La dirección se considera completa si no hay tokens sin resolver, ni componentes de dirección inesperados o faltantes. Si no se establece, indica que el valor es false. Consulta los campos missing_component_types, unresolved_tokens o unexpected para obtener más detalles.

bool

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.

bool

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

bool

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