Location

Un recurso que representa una ubicación con información geográfica completa.

Representación JSON 
{
  "locationType": enum (LocationType),
  "postalAddress": {
    object (PostalAddress)
  },
  "latLng": {
    object (LatLng)
  },
  "radiusMiles": number
}
Campos
locationType

enum (LocationType)

Es el tipo de una ubicación, que corresponde al campo de líneas de dirección de google.type.PostalAddress. Por ejemplo, "Centro, Atlanta, GA, EE.UU." tiene el tipo LocationType.NEIGHBORHOOD, y "Kansas City, KS, EE.UU." tiene el tipo LocationType.LOCALITY.
postalAddress

object (PostalAddress)

Dirección postal de la ubicación que incluye información legible, como direcciones de pago o de envío postal. Si se proporciona una dirección postal, un servicio postal puede enviar artículos a las instalaciones, a la casilla postal o a una ubicación de envío diferente.
latLng

object (LatLng)

Un objeto que representa un par latitud-longitud.
radiusMiles

number

Radio, expresado en millas desde la ubicación del trabajo. Este valor se deriva del cuadro delimitador de la ubicación, en el que un círculo con el radio especificado centrado en google.type.LatLng cubre el área asociada con la ubicación del trabajo. Por ejemplo, actualmente, "Mountain View, CA, EE.UU." tiene un radio de 10.17 kilómetros.

LocationType

Una enumeración que representa el tipo de una ubicación.

Enums
LOCATION_TYPE_UNSPECIFIED El valor predeterminado si no se especifica el tipo.
COUNTRY Una ubicación a nivel de país.
ADMINISTRATIVE_AREA Ubicación a nivel de estado o uno equivalente
SUB_ADMINISTRATIVE_AREA Ubicación a nivel de condado o uno equivalente
LOCALITY Ubicación a nivel de ciudad o uno equivalente
POSTAL_CODE Ubicación a nivel de código postal
SUB_LOCALITY Una sublocalidad es una subdivisión de una localidad, por ejemplo, un municipio, un distrito o un distrito en una ciudad. Por lo general, las sublocalidades son reconocidas por una autoridad política local. Por ejemplo, Manhattan y Brooklyn son reconocidos como barrios por la Ciudad de Nueva York y, por lo tanto, se clasifican como sublocalidades.
SUB_LOCALITY_1 Un distrito o un nivel de ubicación equivalente
SUB_LOCALITY_2 Un distrito más pequeño o un nivel equivalente
NEIGHBORHOOD Una ubicación a nivel de vecindario
STREET_ADDRESS Una ubicación a nivel de dirección

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 para ingresar o editar direcciones: - Usa un widget de dirección compatible con i18n, 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

integer

La revisión del esquema de PostalAddress. Se debe configurar como 0, que es la última versión.

Todas las revisiones nuevas deben ser compatibles con las revisiones anteriores.
regionCode

string

Obligatorio. Código de región de CLDR para el país o la región de la dirección. Nunca se infiere y depende del usuario garantizar que el valor sea correcto. Para obtener más información, consulta http://cldr.unicode.org/ y http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html. Ejemplo: "CH" para Suiza.
languageCode

string

Opcional. Código de idioma BCP-47 de los contenidos de esta dirección (si se conoce). Suele ser el idioma de la IU del formulario de entrada o se espera que coincida con uno de los idiomas usados en la región o el país de la dirección, o sus transliteraciones equivalentes. Esto puede afectar el formato en ciertos países, pero no es fundamental para la precisión de los datos y nunca afectará una validación o alguna otra operación no relacionada con el formato.

Si este valor es desconocido, se debe omitir (en lugar de especificar una configuración predeterminada posiblemente incorrecta).

Ejemplos: "zh-Hant", "ja", "ja-Latn", "en".
postalCode

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

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

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

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 addressLines.
sublocality

string

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

string

Líneas de dirección no estructuradas que describen los niveles más bajos de una dirección.

Debido a que los valores de addressLines 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. En lugares donde esto puede variar, (p. ej., Japón), address_language se usa para hacerlo explícito (p. ej., "ja" para ordenar de mayor a menor en "ja-Latn" o "en" para indicar de menor a mayor). De esta manera, se puede seleccionar la línea más específica de una dirección a partir del idioma.

La representación estructural mínima que se permite para una dirección consiste en un regionCode con toda la información restante incluida en addressLines. Sería posible dar un formato a una dirección así de manera muy aproximada sin codificación geográfica, pero no podría realizarse un análisis semántico de ningún componente de la dirección hasta que se resuelva, al menos, de manera parcial.

Crear una dirección que solo contiene regionCode y addressLines, y luego realizar la codificación geográfica es la manera recomendada de controlar direcciones sin estructura alguna (en lugar de inferir qué partes de la dirección deben ser localidades o áreas administrativas).
recipients[]

string

Opcional. El destinatario en la dirección. Es posible que este campo contenga varias líneas de información en ciertas circunstancias. Por ejemplo, puede contener información sobre la entrega "por medio de".
organization

string

Opcional. El nombre de la organización de la dirección.

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, debe coincidir con el sistema WGS84. Los valores deben pertenecer a rangos normalizados.

Representación JSON 
{
  "latitude": number,
  "longitude": number
}
Campos
latitude

number

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

number

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