Índice
LatLng
(mensaje)PostalAddress
(mensaje)
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.
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]. |
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 dirección 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.
Campos | |
---|---|
revision |
Es la revisión del esquema de |
region_code |
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 |
language_code |
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. |
postal_code |
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). |
sorting_code |
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). |
administrative_area |
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 se debe completar. |
locality |
Opcional. Por lo general, se refiere a la parte de la ciudad o pueblo de la dirección. 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. |
address_lines[] |
Es 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. |