- Solicitud HTTP
- Cuerpo de la solicitud
- Cuerpo de la respuesta
- PostalAddress
- LanguageOptions
- ValidationResult
- Veredicto
- Nivel de detalle
- Dirección
- AddressComponent
- ComponentName
- ConfirmationLevel
- Geocodificación
- LatLng
- PlusCode
- Vista del puerto
- AddressMetadata
- UspsData
- UspsAddress
Valida una dirección.
Solicitud HTTP
POST https://addressvalidation.googleapis.com/v1:validateAddress
La URL usa la sintaxis de la transcodificación gRPC.
Cuerpo de la solicitud
El cuerpo de la solicitud contiene datos con la siguiente estructura:
Representación JSON |
---|
{ "address": { object ( |
Campos | |
---|---|
address |
Obligatorio. La dirección que se está validando. Las direcciones sin formato se deben enviar a través de La longitud total de los campos en esta entrada no debe superar los 280 caracteres. Puedes encontrar las regiones admitidas aquí. El valor La API de Address Validation ignora los valores de |
previousResponseId |
Este campo debe estar vacío para la primera solicitud de validación de dirección. Si se necesitan más solicitudes para validar por completo una sola dirección (por ejemplo, si se deben volver a validar los cambios que realiza el usuario después de la validación inicial), cada solicitud de seguimiento debe propagar este campo con el |
enableUspsCass |
Habilita el modo compatible con CASS de USPS. Esto afecta solo al campo Se recomienda usar un elemento |
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 de los Servicios 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. |
sessionToken |
Opcional. Es una cadena que identifica una sesión de Autocomplete con fines de facturación. Debe ser una string en base64 segura para URL y nombre de archivo con un máximo de 36 caracteres ASCII de longitud. De lo contrario, se muestra un error INVALID_ formato. La sesión comienza cuando el usuario hace 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 consultas 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 una sesión, el token deja de ser válido, y tu app debe generar un token nuevo para cada sesión. Si se omite el parámetro Nota: Address Validation solo se puede usar en sesiones con la API de Autocomplete (nuevo), no en la API de Autocomplete. Para obtener más información, consulta https://developers.google.com/maps/documentation/places/web-service/session-pricing. |
Cuerpo de la respuesta
Es la respuesta a una solicitud de validación de dirección.
Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:
Representación JSON |
---|
{
"result": {
object ( |
Campos | |
---|---|
result |
Es el resultado de la validación de la dirección. |
responseId |
Es el UUID que identifica esta respuesta. Si se debe volver a validar la dirección, este UUID debe acompañar la solicitud nueva. |
PostalAddress
Representa una dirección postal, p. ej., para envíos postales o direcciones de pago. Si se proporciona una dirección postal, un servicio postal puede enviar artículos a las instalaciones, a la casilla postal o a otras ubicaciones similares. No está diseñado para modelar ubicaciones geográficas (caminos, pueblos, montañas).
En el uso común, una dirección se crearía a través de una entrada del usuario o a partir de la importación de datos existentes, según el tipo de proceso.
Consejos sobre el ingreso o edición de direcciones: - Usa un widget de dirección listo para la internacionalización, como https://github.com/google/libaddressinput). - No se deben presentar a los usuarios elementos de la IU para ingresar o editar campos fuera de países en los que se usa ese campo.
Para obtener orientación sobre cómo usar este esquema, consulta https://support.google.com/business/answer/6397478
Representación JSON |
---|
{ "revision": integer, "regionCode": string, "languageCode": string, "postalCode": string, "sortingCode": string, "administrativeArea": string, "locality": string, "sublocality": string, "addressLines": [ string ], "recipients": [ string ], "organization": string } |
Campos | |
---|---|
revision |
La revisión del esquema de |
regionCode |
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 |
languageCode |
El código de idioma de la dirección de entrada se reserva para usos futuros y hoy se ignora. La API muestra la dirección en el idioma adecuado en el que se encuentra. |
postalCode |
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.). |
sortingCode |
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 cadena como "CEDEX", opcionalmente seguida de un número (p.ej., "CEDEX 7"), o solo un número, que representa el "código de sector" (Jamaica), el "indicador de área de entrega" (Malaui) o el "indicador de oficina de correo" (p.ej., Costa de Marfil). |
administrativeArea |
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 particular, para España es 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. |
locality |
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. |
sublocality |
Opcional. Sublocalidad de la dirección. Por ejemplo, pueden ser barrios, vecindarios o distritos. |
addressLines[] |
Obligatorio. Líneas de dirección no estructuradas que describen los niveles más bajos de una dirección. |
recipients[] |
Evita configurar este campo. La API de Address Validation no la usa en la actualidad. Si bien 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. |
organization |
Evita configurar este campo. La API de Address Validation no la usa en la actualidad. Si bien 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. |
LanguageOptions
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 de los Servicios 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.
Representación JSON |
---|
{ "returnEnglishLatinAddress": boolean } |
Campos | |
---|---|
returnEnglishLatinAddress |
Vista previa: muestra un |
ValidationResult
Es el resultado de validar una dirección.
Representación JSON |
---|
{ "verdict": { object ( |
Campos | |
---|---|
verdict |
Marcas de veredicto generales |
address |
Incluye información sobre la dirección en sí, en lugar del geocódigo. |
geocode |
Información sobre la ubicación y el lugar a los que se geocodifica la dirección. |
metadata |
Otra información relevante para la entrega. No se garantiza que |
uspsData |
Marcas de entrega adicionales proporcionadas por el USPS. Solo se proporciona en la región |
englishLatinAddress |
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 de los Servicios de Google Maps Platform. Para obtener más información, consulta las descripciones de la etapa de lanzamiento. Dirección traducida al inglés. Las direcciones traducidas no se pueden reutilizar como entrada de la API. El servicio las ofrece para que el usuario pueda usar su idioma nativo y confirmar o rechazar la validación de la dirección proporcionada en un principio. Si parte de la dirección no tiene una traducción al inglés, el servicio la mostrará en un idioma alternativo que utilice alfabeto latino. Consulta aquí para obtener una explicación de cómo se selecciona el idioma alternativo. Si una parte de la dirección no tiene traducciones o transliteraciones en un idioma que usa alfabeto latino, el servicio muestra esa parte en el idioma local asociado a la dirección. Habilita este resultado con la marca Nota: Los campos |
Veredicto
Descripción general de alto nivel del resultado de validación de la dirección y el geocódigo.
Representación JSON |
---|
{ "inputGranularity": enum ( |
Campos | |
---|---|
inputGranularity |
El nivel de detalle de la dirección de 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 Por ejemplo, si la dirección de entrada incluye un número de departamento específico, |
validationGranularity |
El nivel de detalle en el que la API puede validate por completo la dirección. Por ejemplo, un Puedes encontrar el resultado de la validación del componente por dirección en |
geocodeGranularity |
Información sobre el nivel de detalle de En ocasiones, esto puede diferir del |
addressComplete |
La dirección se considera completa si no hay tokens sin resolver ni componentes de dirección inesperados o faltantes. Si no está establecido, indica que el valor es |
hasUnconfirmedComponents |
Al menos un componente de la dirección no se puede categorizar o validar. Consulta |
hasInferredComponents |
Se infirió (agregado) al menos un componente de la dirección que no estaba en la entrada. Consulta |
hasReplacedComponents |
Se reemplazó al menos un componente de la dirección. Consulta |
Nivel de detalle
Los diversos niveles de detalle que puede tener una dirección o un geocódigo. Cuando se usan para indicar el nivel de detalle de una dirección, estos valores indican con qué nivel de detalle la dirección identifica a un destino de correo postal. Por ejemplo, una dirección como “123 Main Street, Redwood City, CA, 94061” identifica una PREMISE
, mientras que algo como “Redwood City, CA, 94061” identifica una LOCALITY
. Sin embargo, si no podemos encontrar un geocódigo para "123 Main Street" en Redwood City, es posible que el geocódigo que se muestra tenga un nivel de detalle de LOCALITY
, aunque la dirección sea más detallada.
Enumeradores | |
---|---|
GRANULARITY_UNSPECIFIED |
Valor predeterminado Este valor no se usa. |
SUB_PREMISE |
Resultado del nivel de edificio debajo del edificio, como un departamento. |
PREMISE |
Resultado a nivel de edificio. |
PREMISE_PROXIMITY |
Un geocódigo que aproxima la ubicación de la dirección a nivel de edificio. |
BLOCK |
La dirección o el geocódigo indican un bloque. Solo se usa en regiones con direcciones a nivel de bloque, como Japón. |
ROUTE |
El geocódigo o la dirección son granulares para la ruta, como una calle, una ruta o una autopista. |
OTHER |
Todas las demás granularidades, que se agrupan debido a que no se pueden entregar |
Dirección
Detalles de la dirección después del procesamiento. El procesamiento posterior incluye corregir las partes con errores ortográficos de la dirección, reemplazar las partes incorrectas e inferir las partes faltantes.
Representación JSON |
---|
{ "formattedAddress": string, "postalAddress": { object ( |
Campos | |
---|---|
formattedAddress |
La dirección que se procesó con posterioridad, con el formato de una dirección de una sola línea que sigue las reglas de formato de dirección de la región donde se encuentra la dirección. |
postalAddress |
La dirección con procesamiento posterior, representada como una dirección postal. |
addressComponents[] |
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 dirección no están ordenados de manera particular. No hagas suposiciones sobre el orden de los componentes de dirección en la lista. |
missingComponentTypes[] |
Los tipos de componentes que se esperaba que estuvieran presentes en una dirección de correo con 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 |
unconfirmedComponentTypes[] |
Son los tipos de componentes presentes en |
unresolvedTokens[] |
Cualquier token de 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 podrían parecerse a |
AddressComponent
Representa un componente de dirección, como una calle, una ciudad o un estado.
Representación JSON |
---|
{ "componentName": { object ( |
Campos | |
---|---|
componentName |
El nombre de este componente. |
componentType |
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. |
confirmationLevel |
Indica el nivel de certeza que tenemos de que el componente sea correcto. |
inferred |
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. |
spellCorrected |
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 se marcan los errores ortográficos comunes, como al cambiar “Amphitheater Pkwy” a “Amphitheatre Pkwy”. |
replaced |
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, ya que el componente de entrada se cambió por uno diferente. |
unexpected |
Indica un componente de dirección que no se espera que esté presente en una dirección postal para una región determinada. Lo retenemos solo porque era parte de la entrada. |
ComponentName
Wrapper para el nombre del componente.
Representación JSON |
---|
{ "text": string, "languageCode": string } |
Campos | |
---|---|
text |
Es el texto del nombre. Por ejemplo, "Quinta Avenida" para el nombre de una calle o "1253" para el número de una calle. |
languageCode |
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. |
ConfirmationLevel
Los diferentes valores posibles para los niveles de confirmación.
Enumeradores | |
---|---|
CONFIRMATION_LEVEL_UNSPECIFIED |
Valor predeterminado Este valor no se usa. |
CONFIRMED |
Pudimos verificar que este componente existe y tiene sentido en el contexto del resto de la dirección. |
UNCONFIRMED_BUT_PLAUSIBLE |
No se pudo confirmar este componente, pero es creíble que exista. Por ejemplo, el número de una calle dentro de un rango de números válido conocido en una calle en la que no se conocen números de casa específicos. |
UNCONFIRMED_AND_SUSPICIOUS |
Este componente no se confirmó y es probable que sea incorrecto. Por ejemplo, un vecindario que no coincide con el resto de la dirección. |
Geocodificación
Contiene información sobre el lugar hasta el que se geocodificaron los datos de entrada.
Representación JSON |
---|
{ "location": { object ( |
Campos | |
---|---|
location |
Es la ubicación geocodificada de la entrada. Es preferible usar IDs de lugar en lugar de direcciones, coordenadas de latitud y longitud o códigos plus. El uso de coordenadas al enrutar o calcular indicaciones siempre dará como resultado que el punto se ajuste a la ruta más cercana a esas coordenadas. Puede que esta no sea una ruta que lleve al destino de forma rápida o segura, ni que esté cerca de un punto de acceso a la propiedad. Además, cuando una ubicación tiene una geocodificación inversa, no hay garantía de que la dirección devuelta coincida con la original. |
plusCode |
El Plus Code correspondiente a |
bounds |
Límites del sitio geocodificado. |
featureSizeMeters |
Indica el tamaño del lugar geocodificado en metros. Esta es otra medida de la aspereza de la ubicación geocodificada, pero en cuanto a tamaño físico y no por significado semántico. |
placeId |
El PlaceID del lugar con el que se geocodifica esta entrada. Para obtener más información sobre los IDs de lugar, consulta este vínculo. |
placeTypes[] |
Los tipos de lugar a los que se geocodifica la entrada. Por ejemplo, |
LatLng
Es un objeto que representa un par de valores de latitud y longitud. Esto se expresa como un par de dobles para representar la latitud en grados y la longitud en grados. A menos que se especifique lo contrario, este objeto debe cumplir con el estándar WGS84. Los valores deben pertenecer a rangos normalizados.
Representación JSON |
---|
{ "latitude": number, "longitude": number } |
Campos | |
---|---|
latitude |
La latitud expresada en grados. Debe pertenecer al rango [-90.0, +90.0]. |
longitude |
La longitud expresada en grados. Debe pertenecer al rango [-180.0, +180.0]. |
PlusCode
El Plus Code (http://plus.codes) es una referencia de ubicación con dos formatos: un código global que define un rectángulo de 14 mx14 m (1/8, 000 de un grado) o un rectángulo más pequeño, y un código compuesto que reemplaza el prefijo por una ubicación de referencia.
Representación JSON |
---|
{ "globalCode": string, "compoundCode": string } |
Campos | |
---|---|
globalCode |
Código global (completo) del sitio, como "9FWM33GV+HQ", que representa un área de 1/8000 por 1/8000 grados (~14 por 14 metros). |
compoundCode |
Es el código compuesto del lugar, como "33GV+HQ, Ramberg, Noruega", que contiene el sufijo del código global y reemplaza el prefijo por el nombre con formato de una entidad de referencia. |
Viewport
Un viewport de latitud y longitud, representado por dos puntos diagonales low
y high
opuestos. Una viewport se considera una región cerrada, es decir, incluye su límite. Los límites de latitud deben variar entre -90 y 90 grados inclusive, y los límites de longitud deben variar de -180 a 180 grados inclusive. Entre los diversos casos, se incluyen los siguientes:
Si
low
=high
, el viewport consta de ese único punto.Si
low.longitude
>high.longitude
, el rango de longitud se invierte (el viewport cruza la línea de longitud de 180 grados).Si
low.longitude
= -180 grados yhigh.longitude
= 180 grados, el viewport incluye todas las longitudes.Si
low.longitude
= 180 grados yhigh.longitude
= -180 grados, el rango de longitud estará vacío.Si
low.latitude
>high.latitude
, el rango de latitud está vacío.
Tanto low
como high
deben completarse, y el cuadro representado no puede estar vacío (como se especifica en las definiciones anteriores). Un viewport vacío generará un error.
Por ejemplo, este viewport abarca por completo la ciudad de Nueva York:
{ "low": { "latitude": 40.477398, "longitude": -74.259087 }, "high": { "latitude": 40.91618, "longitude": -73.70018 } }
Representación JSON |
---|
{ "low": { object ( |
Campos | |
---|---|
low |
Obligatorio. El punto inferior del viewport. |
high |
Obligatorio. El punto alto del viewport. |
AddressMetadata
Los metadatos de la dirección. No se garantiza que metadata
se propague por completo para cada dirección que se envíe a la API de Address Validation.
Representación JSON |
---|
{ "business": boolean, "poBox": boolean, "residential": boolean } |
Campos | |
---|---|
business |
Indica que esta es la dirección de una empresa. Si no está establecido, indica que el valor es desconocido. |
poBox |
Indica la dirección de un apartado postal. Si no está establecido, indica que el valor es desconocido. |
residential |
Indica que esta es la dirección de una residencia. Si no está establecido, indica que el valor es desconocido. |
UspsData
Los datos del USPS para la dirección. No se garantiza que uspsData
esté completamente propagado para cada dirección de EE.UU. o de relaciones públicas que se envía a la API de Address Validation. Si usas uspsData como la parte principal de la respuesta, te recomendamos integrar los campos de la dirección de respaldo.
Representación JSON |
---|
{
"standardizedAddress": {
object ( |
Campos | |
---|---|
standardizedAddress |
Dirección estandarizada del USPS. |
deliveryPointCode |
Código de punto de entrega de 2 dígitos |
deliveryPointCheckDigit |
El dígito de control del punto de entrega. Este número se agrega al final de delivery_point_barcode para los correos electrónicos escaneados mecánicamente. Si sumas todos los dígitos de delivery_point_barcode, deliveryPointCheckDigit, código postal y ZIP+4, deberías obtener un número divisible por 10. |
dpvConfirmation |
Son los valores posibles para la confirmación de DPV. Muestra un solo carácter o no muestra ningún valor.
|
dpvFootnote |
Notas al pie de la validación del punto de entrega. Se pueden combinar varias notas al pie en la misma cadena.
|
dpvCmra |
Indica si la dirección corresponde a una CMRA (agencia de recepción de correo comercial), que es una empresa privada que recibe correo de los clientes. Muestra un solo carácter.
|
dpvVacant |
¿Este lugar está vacante? Muestra un solo carácter.
|
dpvNoStat |
¿Es una dirección sin estadísticas o una dirección activa? No hay direcciones de estadísticas son aquellas que no se ocupan continuamente o direcciones que el USPS no presta servicios. Muestra un solo carácter.
|
dpvNoStatReasonCode |
Indica el tipo NoStat. Muestra un código de motivo como int.
|
dpvDrop |
La marca indica que el correo se entrega a un único lugar receptivo en un sitio. Muestra un solo carácter.
|
dpvThrowback |
Indica que no se ha entregado el correo a esa dirección. Muestra un solo carácter.
|
dpvNonDeliveryDays |
La marca indica que la entrega de correo no se realiza todos los días de la semana. Muestra un solo carácter.
|
dpvNonDeliveryDaysValues |
Número entero que identifica los días de la falta de entrega. Se puede interactuar con marcas de bits: 0x40: el domingo es un día sin entrega 0 x 20; el lunes es un día sin entrega 0 x 10; 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 0x02; el viernes es un día sin entrega 0x02; el viernes es un día sin entrega 0x02 |
dpvNoSecureLocation |
La bandera indica que se puede acceder a la puerta, pero no se dejará el paquete por cuestiones de seguridad. Muestra un solo carácter.
|
dpvPbsa |
Indica que la dirección coincidió con el registro PBSA. Muestra un solo carácter.
|
dpvDoorNotAccessible |
La bandera indica las direcciones en las que el USPS no puede pedir acceso a una puerta para entregar el correo. Muestra un solo carácter.
|
dpvEnhancedDeliveryCode |
Indica que hay más de un código de devolución DPV válido para la dirección. Muestra un solo carácter.
|
carrierRoute |
Es el código de ruta de la empresa de transporte. Un código de cuatro caracteres que consta de un prefijo de una letra y un designador de ruta de tres dígitos. Prefijos:
|
carrierRouteIndicator |
Indicador de orden de la tarifa de la ruta de la empresa de transporte. |
ewsNoMatch |
La dirección de entrega coincide, pero el archivo EWS indica que una coincidencia exacta estará disponible pronto. |
postOfficeCity |
Ciudad de la oficina postal principal |
postOfficeState |
Estado de la oficina de correos principal |
abbreviatedCity |
Ciudad abreviada. |
fipsCountyCode |
código de condado del FIPS. |
county |
Nombre del condado. |
elotNumber |
Número de línea de viaje mejorada (eLOT). |
elotFlag |
eLOT ascendente/descendente (A/D). |
lacsLinkReturnCode |
Código de devolución de LACSLink. |
lacsLinkIndicator |
Indicador de vínculo de LACS. |
poBoxOnlyPostalCode |
Código postal solo en apartado postal |
suitelinkFootnote |
Notas al pie que hacen coincidir el registro de una calle o un edificio alto con la información de un local. Si se encuentra una coincidencia con el nombre de la empresa, se devuelve el número secundario.
|
pmbDesignator |
Designador de unidad de PMB (Buzón de correo privado). |
pmbNumber |
Número de PMB (buzón de correo privado); |
addressRecordType |
Tipo del registro de dirección que coincide con la dirección de entrada.
|
defaultAddress |
Indicador de que se encontró una dirección predeterminada, pero existe una dirección más específica. |
errorMessage |
Mensaje de error para la recuperación de datos del USPS. 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 esté presente este error. |
cassProcessed |
Indicador de que se procesó la solicitud de CASS. |
UspsAddress
Representación del USPS de una dirección de EE.UU.
Representación JSON |
---|
{ "firstAddressLine": string, "firm": string, "secondAddressLine": string, "urbanization": string, "cityStateZipAddressLine": string, "city": string, "state": string, "zipCode": string, "zipCodeExtension": string } |
Campos | |
---|---|
firstAddressLine |
Primera línea de dirección. |
firm |
Nombre de la empresa. |
secondAddressLine |
Segunda línea de dirección. |
urbanization |
Nombre de la urbanización puertorriqueña. |
cityStateZipAddressLine |
Ciudad + estado + código postal |
city |
Nombre de la ciudad. |
state |
Código de estado de 2 letras. |
zipCode |
Código postal, p.ej., 10009. |
zipCodeExtension |
Extensión de código postal de 4 dígitos, p.ej., 5023. |