Índice
LatLng
(mensagem)PostalAddress
(mensagem)
LatLng
Um objeto que representa um par de latitude/longitude. Ele é expresso como um par de valores duplos para representar graus de latitude e longitude. A menos que especificado de outra forma, esse objeto precisa seguir o padrão WGS84. Os valores precisam estar dentro de intervalos normalizados.
Campos | |
---|---|
latitude |
A latitude em graus. Precisa estar no intervalo [-90,0, +90,0]. |
longitude |
A longitude em graus. Precisa estar no intervalo [-180,0, +180,0]. |
PostalAddress
Representa um endereço postal (por exemplo, endereços para pagamento ou envio postal). Com um endereço postal, o serviço de correios pode entregar itens em um local, caixa postal ou lugar semelhante. Não se destina a modelar locais geográficos (estradas, cidades, montanhas).
No uso normal, um endereço seria criado por entrada do usuário ou pela importação de dados, dependendo do tipo de processo.
Orientações sobre a inserção ou edição de endereços: – Use um widget de endereços pronto para internacionalização, como https://github.com/google/libaddressinput. – Os usuários não devem ver elementos da IU para inserção ou edição de campos fora dos países em que os campos são usados.
Para mais orientações sobre como usar este esquema, consulte: https://support.google.com/business/answer/6397478.
Campos | |
---|---|
revision |
A revisão do esquema do |
region_code |
Opcional. Código de região CLDR do país/região do endereço. Para detalhes, consulte https://cldr.unicode.org/ e https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html. Exemplo: "CH" para Suíça. Se o código da região não for fornecido, ele será inferido com base no endereço. Para ter o melhor desempenho, recomendamos incluir o código da região, se você souber. Ter regiões inconsistentes ou repetidas pode prejudicar a performance. Por exemplo, se |
language_code |
O código de idioma no endereço de entrada é reservado para uso futuro e é ignorado no momento. A API retorna o endereço no idioma apropriado para o local. |
postal_code |
Opcional. Código postal do endereço. Nem todos os países usam ou exigem códigos postais, mas, quando são usados, eles podem acionar uma validação adicional com outras partes do endereço (por exemplo, validação de estado ou CEP nos Estados Unidos). |
sorting_code |
Opcional. Código de classificação adicional específico de país. Não é usado na maioria das regiões. Quando usado, o valor é uma string como "CEDEX", opcionalmente seguida por um número (por exemplo, "CEDEX 7") ou apenas um número, representando o "código do setor" (Jamaica), o "indicador de área de entrega" (Malawi) ou o "indicador de correio" (Costa do Marfim). |
administrative_area |
Opcional. A maior subdivisão administrativa que é usada para endereços postais de um país ou uma região. Por exemplo, pode ser um estado, uma província, uma zona ou uma prefeitura. Na Espanha, é a província, e não a comunidade autônoma (por exemplo, "Barcelona", não "Catalunha"). Muitos países não usam área administrativa em endereços postais. Por exemplo, na Suíça, ela deve ficar em branco. |
locality |
Opcional. Geralmente se refere à parte do endereço relacionada à cidade/município. Exemplos: cidade nos EUA, comunidade na Itália, distrito postal no Reino Unido. Em regiões administrativas que não são claramente definidas ou não se encaixam bem nessa estrutura, deixe |
sublocality |
Opcional. Sublocalidade do endereço. Por exemplo, pode ser um bairro ou distrito. |
address_lines[] |
Obrigatório. Linhas de endereço não estruturadas que descrevem os níveis mais baixos de um endereço. |
recipients[] |
Evite definir este campo. No momento, a API Address Validation não o usa. Embora a API não rejeite solicitações com esse campo definido, as informações serão descartadas e não serão retornadas na resposta. |
organization |
Evite definir este campo. No momento, a API Address Validation não o usa. Embora a API não rejeite solicitações com esse campo definido, as informações serão descartadas e não serão retornadas na resposta. |