- Solicitud HTTP
- Cuerpo de la solicitud
- Cuerpo de la respuesta
- PostalAddress
- LanguageOptions
- ValidationResult
- Verdict
- Nivel de detalle
- Dirección
- AddressComponent
- ComponentName
- ConfirmationLevel
- Geocodificar
- LatLng
- PlusCode
- Ventana de visualización
- 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 de esta entrada no debe exceder 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 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 |
enableUspsCass |
Habilita el modo compatible con CASS de USPS. Esto afecta solo al campo Se recomienda usar un |
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. |
sessionToken |
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 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. |
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 la dirección debe volver a validarse, este UUID debe acompañar a la solicitud nueva. |
PostalAddress
Representa una dirección postal (por ejemplo, para direcciones de entrega postal o de pagos). Si se proporciona una dirección postal, un servicio postal puede entregar artículos a una propiedad, un apartado postal o algo similar. No está diseñado para modelar ubicaciones geográficas (caminos, pueblos, montañas).
En el uso típico, una dirección se crearía a partir de la entrada del usuario o de la importación de datos existentes, según el tipo de proceso.
Sugerencias para la entrada o edición de direcciones: - Usa un widget de direcciones listo para la internacionalización, como https://github.com/google/libaddressinput. - No se debe presentar a los usuarios elementos de la IU para ingresar o editar campos fuera de los países en los que se usa ese campo.
Para obtener más 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 |
Es 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. Consulta https://cldr.unicode.org/ y https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html para obtener más información. 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. Tener regiones inconsistentes o repetidas puede generar un rendimiento deficiente. Por ejemplo, si el |
languageCode |
El código de idioma en la dirección de entrada se reserva para usos futuros y se ignora en la actualidad. La API muestra la dirección en el idioma apropiado para la ubicación. |
postalCode |
Opcional. Código postal de la dirección. No todos los países usan códigos postales ni requieren que estén presentes, pero, cuando se usan, pueden activar una validación adicional con otras partes de la dirección (por ejemplo, la validación del estado o el código postal en Estados Unidos). |
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", seguida de un número (por ejemplo, "CEDEX 7") o solo un número, que representa el "código de sector" (Jamaica), el "indicador de zona de entrega" (Malawi) o el "indicador de oficina de correos" (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 el caso de España, se trata de la provincia y no de la comunidad autónoma (por ejemplo, "Barcelona" y no "Cataluña"). Muchos países no usan un área administrativa en las direcciones postales. Por ejemplo, en Suiza, este campo no debe propagarse. |
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 las regiones del mundo donde las localidades no están bien definidas o no se ajustan a esta estructura, deja |
sublocality |
Opcional. Sublocalidad de la dirección. Por ejemplo, puede ser un vecindario, un distrito o un barrio. |
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. Actualmente, la API de Address Validation no la usa. 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. Actualmente, la API de Address Validation no la usa. 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 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.
Representación JSON |
---|
{ "returnEnglishLatinAddress": boolean } |
Campos | |
---|---|
returnEnglishLatinAddress |
Vista previa: Muestra un |
ValidationResult
Es el resultado de la validación de una dirección.
Campos | |
---|---|
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. |
metadata |
Otra información relevante para la entrega No se garantiza que |
uspsData |
Marcas de entrega adicionales proporcionadas por USPS. Solo se proporciona en las regiones |
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 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 Nota: No se propagan los campos |
Veredicto
Descripción general de alto nivel del resultado de la 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 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 Por ejemplo, si la dirección de entrada incluye un número de departamento específico, el |
validationGranularity |
Es el nivel de detalle hasta el que la API puede validar la dirección. Por ejemplo, un El resultado de la validación de cada componente de la dirección se puede encontrar en |
geocodeGranularity |
Información sobre el nivel de detalle de En ocasiones, 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 se establece, indica que el valor es |
hasUnconfirmedComponents |
Al menos un componente de la dirección no se puede categorizar ni validar. Consulta |
hasInferredComponents |
Se infirió (agregó) al menos un componente de 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 diferentes niveles de detalle que puede tener una dirección o un código geográfico. 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 un destino de correo. Por ejemplo, una dirección como "123 Main Street, Redwood City, CA, 94061" identifica un PREMISE
, mientras que una dirección como "Redwood City, CA, 94061" identifica un LOCALITY
. Sin embargo, si no podemos encontrar una geocodificación para "123 Main Street" en Redwood City, la geocodificación que se muestra puede ser de nivel de detalle LOCALITY
, aunque la dirección sea más detallada.
Enumeraciones | |
---|---|
GRANULARITY_UNSPECIFIED |
Valor predeterminado Este valor no se usa. |
SUB_PREMISE |
Es un resultado inferior al nivel del edificio, como un departamento. |
PREMISE |
Resultado a nivel del edificio. |
PREMISE_PROXIMITY |
Es un código geodésico que aproxima la ubicación a nivel del edificio de la dirección. |
BLOCK |
La dirección o el geocódigo indican un bloque. Solo se usa en regiones que tienen direcciones a nivel de bloque, como Japón. |
ROUTE |
El geocódigo o la dirección es detallado para la ruta, como una calle, una ruta o una autopista. |
OTHER |
Todos los demás niveles de detalle, que se agrupan, ya que no se pueden entregar. |
Dirección
Son los detalles de la dirección después del procesamiento. El procesamiento posterior incluye corregir las partes de la dirección con errores ortográficos, reemplazar las partes incorrectas y deducir las partes faltantes.
Representación JSON |
---|
{ "formattedAddress": string, "postalAddress": { object ( |
Campos | |
---|---|
formattedAddress |
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 |
postalAddress |
Es la dirección procesada después, 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 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. |
missingComponentTypes[] |
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 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 "渋谷区渋谷3丁目 Shibuya Stream", el nombre del edificio "Shibuya Stream" tiene el tipo de componente |
unconfirmedComponentTypes[] |
Son los tipos de componentes que están presentes en |
unresolvedTokens[] |
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 |
AddressComponent
Representa un componente de dirección, como una calle, una ciudad o un estado.
Representación JSON |
---|
{ "componentName": { object ( |
Campos | |
---|---|
componentName |
Es el nombre de este componente. |
componentType |
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. |
inferred |
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. |
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 marca los errores ortográficos comunes, como cuando se cambia "Amphitheater Pkwy" por "Amphitheatre Pkwy". |
replaced |
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. |
unexpected |
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. |
ComponentName
Es un wrapper para el nombre del componente.
Representación JSON |
---|
{ "text": string, "languageCode": string } |
Campos | |
---|---|
text |
Es el texto del nombre. Por ejemplo, "5th Avenue" para un nombre de calle o "1253" para un número de 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.
Enumeraciones | |
---|---|
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 posible que exista. Por ejemplo, un número de calle dentro de un rango válido conocido de números en una calle donde no se conocen los 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 al que se geocodió la entrada.
Campos | |
---|---|
location |
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 |
bounds |
Los límites del lugar geocodificado |
featureSizeMeters |
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. |
placeId |
El PlaceID del lugar al que geocodifica esta entrada. Para obtener más información sobre los IDs de lugar, consulta este artículo. |
placeTypes[] |
Los tipos de lugares a los que se geocodió 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 números de punto flotante de doble precisión que representan los grados de latitud y longitud. 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: el código global, que define un rectángulo de 14 m x 14 m (1/8,000 de un grado) o menos, y el código compuesto, que reemplaza el prefijo por una ubicación de referencia.
Representación JSON |
---|
{ "globalCode": string, "compoundCode": string } |
Campos | |
---|---|
globalCode |
Es el código global (completo) del lugar, como "9FWM33GV+HQ", que representa un área de 1/8,000 de un grado por 1/8,000 de un grado (~14 por 14 metros). |
compoundCode |
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 |
Viewport
Un viewport de latitud-longitud, representado como dos puntos low
y high
diagonalmente opuestos. Un viewport se considera una región cerrada, es decir, incluye su límite. Los límites de latitud deben estar entre -90 y 90 grados inclusive, y los límites de longitud deben estar entre -180 y 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 está vacío.Si
low.latitude
>high.latitude
, el rango de latitud está vacío.
Se deben propagar low
y high
, y el cuadro representado no puede estar vacío (como se especifica en las definiciones anteriores). Si el viewport está vacío, se generará un error.
Por ejemplo, este viewport encierra por completo la ciudad de Nueva York:
{ "low": { "latitude": 40.477398, "longitude": -74.259087 }, "high": { "latitude": 40.91618, "longitude": -73.70018 } }
AddressMetadata
Son 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 se establece, indica que el valor es desconocido. |
poBox |
Indica que la dirección es un apartado postal. Si no se establece, indica que el valor es desconocido. |
residential |
Indica que esta es la dirección de una residencia. Si no se establece, indica que el valor es desconocido. |
UspsData
Los datos del USPS de la dirección No se garantiza que uspsData
se propague por completo para cada dirección de EE.UU. o Puerto Rico que se envíe a la API de Address Validation. Se recomienda integrar los campos de dirección de respaldo en la respuesta si usas uspsData como la parte principal de la respuesta.
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 del código de barras de delivery_point para el correo escaneado mecánicamente. Si sumas todos los dígitos de delivery_point_barcode, deliveryPointCheckDigit, postal_code 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 |
Las notas al pie de la validación del punto de entrega Se pueden unir varias notas al pie en la misma cadena.
|
dpvCmra |
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.
|
dpvVacant |
¿Está disponible este lugar? Muestra un solo carácter.
|
dpvNoStat |
¿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.
|
dpvNoStatReasonCode |
Indica el tipo de NoStat. Muestra un código de motivo como int.
|
dpvDrop |
La marca indica que el correo se entrega a un solo receptáculo en un sitio. Muestra un solo carácter.
|
dpvThrowback |
Indica que el correo no se entrega a la 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 |
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. |
dpvNoSecureLocation |
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.
|
dpvPbsa |
Indica que la dirección coincide con el registro de PBSA. Muestra un solo carácter.
|
dpvDoorNotAccessible |
La marca indica las direcciones en las que el USPS no puede tocar la puerta para entregar el correo. Muestra un solo carácter.
|
dpvEnhancedDeliveryCode |
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.
|
carrierRoute |
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:
|
carrierRouteIndicator |
Indicador de clasificación de tarifas de ruta de la empresa de transporte. |
ewsNoMatch |
La dirección de entrega coincide, pero el archivo EWS indica que pronto estará disponible una coincidencia exacta. |
postOfficeCity |
Ciudad de la oficina de correos principal |
postOfficeState |
Estado de la oficina de correos principal. |
abbreviatedCity |
Es la ciudad abreviada. |
fipsCountyCode |
Código de condado del FIPS. |
county |
Es el nombre del condado. |
elotNumber |
Número de línea de viaje mejorada (eLOT). |
elotFlag |
Marca ascendente o descendente de eLOT (A/D). |
lacsLinkReturnCode |
Código de retorno de LACSLink. |
lacsLinkIndicator |
Indicador de LACSLink. |
poBoxOnlyPostalCode |
Código postal solo para apartados postales |
suitelinkFootnote |
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.
|
pmbDesignator |
Designador de unidad de PMB (buzón privado). |
pmbNumber |
Número de PMB (buzón privado) |
addressRecordType |
Es el tipo de registro de dirección que coincide con la dirección de entrada.
|
defaultAddress |
Indica que se encontró una dirección predeterminada, pero existen direcciones más específicas. |
errorMessage |
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. |
cassProcessed |
Es un indicador de que la solicitud se procesó según el 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 la dirección. |
urbanization |
Nombre de la urbanización de Puerto Rico. |
cityStateZipAddressLine |
Ciudad, estado y código postal |
city |
Nombre de la ciudad. |
state |
Es un 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. |