Package google.type

Índice

LatLng

Es un objeto que representa un par de valores de latitud y longitud. Esto se expresa como un par de dobles para representar 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.

Campos
latitude

double

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

longitude

double

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

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 la edición de direcciones: - Usa un widget de dirección listo para la internacionalización como https://github.com/google/libaddressinput) - Los usuarios no deben ver elementos de la IU para ingresar o editar campos fuera de países en los que se usa.

Para obtener orientación sobre cómo usar este esquema, consulta https://support.google.com/business/answer/6397478

Campos
revision

int32

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

region_code

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 deducirá de la dirección. Para obtener el mejor rendimiento, se recomienda incluir el código de región, si lo conoce. Tener regiones incoherentes o repetidas puede generar un rendimiento deficiente. Por ejemplo, si address_lines ya incluye la región, no vuelvas a proporcionar el código de región en este campo. Puedes encontrar las regiones admitidas en las Preguntas frecuentes.

language_code

string

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

postal_code

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.).

sorting_code

string

Opcional. Código de ordenamiento adicional específico para cada país. No se usa en la mayoría de las regiones. Cuando se utiliza, el valor es una cadena como &CEDEX; opcionalmente seguida por un número (p. ej. "CEDEX 7), o solo un número, que representa el "código de la sección" (Jamaica), el indicador de área de entrega (Malawi) o el indicador de oficina de correos.

administrative_area

string

Opcional. División administrativa más alta que se usa para las direcciones postales de un país o una región. Por ejemplo, puede ser un estado, una provincia, una óblast o una prefectura. En el caso específico de España, corresponde a la provincia y no a 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

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 address_lines.

sublocality

string

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

address_lines[]

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 en address_lines 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 que se permite para una dirección consiste en toda la información que se incluye en address_lines. Si no se proporciona un region_code, la región se infiere de las líneas de dirección.

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

recipients[]

string

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

organization

string

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