Divisions: divisionsByAddress

Procura divisões geográficas políticas para um único endereço. Faça o teste agora.

Solicitação

Solicitação HTTP

GET https://www.googleapis.com/civicinfo/v2/divisionsByAddress

Parâmetros

Nome do parâmetro Valor Descrição
Parâmetros de consulta opcionais
address string O endereço a ser pesquisado.

Corpo da solicitação

Não forneça um corpo de solicitação com este método.

Resposta

Se for bem-sucedido, esse método retornará um corpo de resposta com esta estrutura:

{
  "kind": "civicinfo#divisionsByAddressResponse",
  "normalizedInput": {
    "locationName": string,
    "line1": string,
    "line2": string,
    "line3": string,
    "city": string,
    "state": string,
    "zip": string,
  },
  "divisions": {
    key: {
      "name": string,
        "alsoKnownAs": [
        string
      ],
    },
  }
Nome da propriedade Valor Descrição Observações
kind string

Identifica o tipo de recurso.

Valor: a string fixa "civicinfo#divisionsByAddressResponse".

normalizedInput nested object A versão normalizada do endereço solicitado.
normalizedInput.locationName string Nome do local.
normalizedInput.line1 string O nome e o número da rua do endereço.
normalizedInput.line2 string A segunda linha do endereço, se necessário.
normalizedInput.line3 string A terceira linha do endereço, se necessário.
normalizedInput.city string A cidade do endereço.
normalizedInput.state string A abreviação de dois caracteres do estado dos EUA do endereço.
normalizedInput.zip string O CEP do endereço nos EUA.
divisions object Divisões geográficas políticas que contêm o endereço solicitado.
divisions.(key) nested object O identificador de dados cívicos abertos (ID do DCA) exclusivo da divisão.
divisions.(key).alsoKnownAs[] list

Qualquer outro ID de OCD válido que se refira à mesma divisão.

Como os IDs de OCD são legíveis por humanos e previsíveis, às vezes há vários identificadores para uma única divisão. Esses identificadores são definidos como equivalentes entre si, e um é sempre indicado como o identificador principal. O identificador principal é retornado no ID de OCD, e todos os outros identificadores válidos equivalentes são retornados na lista.

Por exemplo, se o ID do OCD da divisão a seguir for ocd-division/country:us/district:dc, a lista conterá ocd-division/country:us/state:dc.

divisions.(key).name string O nome da divisão.

Confira!