Package google.type

Índice

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. Salvo indicação em contrário, esse objeto precisa estar em conformidade com o padrão WGS84. Os valores precisam estar dentro de intervalos normalizados.

Campos
latitude

double

A latitude em graus. Precisa estar no intervalo [-90,0, +90,0].
longitude

double

A longitude em graus. Precisa estar no intervalo [-180,0, +180,0].

PostalAddress

Representa um endereço postal, por exemplo, para endereços para pagamento ou distribuição postal. Com um endereço postal, o serviço de correios pode entregar itens em um local, uma caixa postal ou outro local semelhante. Não se destina a modelar locais geográficos (estradas, cidades, montanhas).

No uso normal, um endereço seria criado por digitação do usuário ou pela importação de dados existentes, dependendo do tipo de processo.

Orientações sobre a inserção / edição de endereços: – Use um widget de endereço 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

int32

A revisão do esquema do PostalAddress. Qualquer valor diferente de 0 fará com que a API retorne um erro INVALID_ARGUMENT.
region_code

string

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 melhorar a performance, é recomendável incluir o código da região, se você souber. Ter regiões inconsistentes ou repetidas pode prejudicar a performance. Por exemplo, se address_lines já inclui a região, não forneça o código da região novamente neste campo. As regiões com suporte estão disponíveis nas Perguntas frequentes.
language_code

string

O código de idioma no endereço de entrada é reservado para usos futuros e é ignorado no momento. A API retorna o endereço no idioma apropriado para o local.
postal_code

string

Opcional. Código postal do endereço. Nem todos os países usam ou exigem códigos postais, mas nos locais onde são usados, eles podem desencadear uma validação adicional com outras partes do endereço (por exemplo, validação de estado/CEP nos EUA).
sorting_code

string

Opcional. Código de classificação adicional específico de país. Não é usado na maioria das regiões. Nos locais em que é usado, o valor é uma string como “CEDEX”, que pode ser seguida por um número (por exemplo, “CEDEX 7”), ou apenas um número sozinho, representando o “código do setor” (Jamaica), o “indicador de área de entrega” (Malawi) ou o “indicador de agência de correio” (por exemplo, Costa do Marfim).
administrative_area

string

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. Especificamente 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, isso deve ser deixado em branco.
locality

string

Opcional. Geralmente se refere à parte do endereço relativa a cidade/município. Exemplos: cidade nos EUA, comunidade na Itália, distrito postal no Reino Unido. Em regiões em que as localidades não são claramente definidas ou não se encaixam bem nessa estrutura, deixe a localidade em branco e use address_lines.
sublocality

string

Opcional. Sublocalidade do endereço. Por exemplo, pode ser bairro ou distrito.
address_lines[]

string

Obrigatório. Linhas de endereço não estruturadas que descrevem os níveis mais baixos de um endereço.

Como os valores em address_lines não têm informações de tipo e podem conter diversos valores em um único campo (por exemplo, "Austin, TX"), é importante que a ordem da linha seja clara. Ela precisa estar em "ordem de envelope" para o país ou região do endereço.

A representação estrutural mínima permitida de um endereço consiste em todas as informações colocadas no address_lines. Se um region_code não for fornecido, a região será inferida das linhas de endereço.

Criar um endereço que contenha apenas address_lines e depois geocodificar é a maneira recomendada de lidar com endereços não estruturados (em vez de adivinhar quais partes do endereço devem ser regiões ou áreas administrativas).
recipients[]

string

Evite definir esse campo. No momento, a API Address Validation não o usa. Embora, no momento, a API não rejeite solicitações com esse conjunto de campos, as informações serão descartadas e não serão retornadas na resposta.
organization

string

Evite definir este campo. No momento, ela não é usada pela API Address Validation. Embora, no momento, a API não rejeite solicitações com esse conjunto de campos, as informações serão descartadas e não serão retornadas na resposta.