Page Summary
-
This method looks up political geographic divisions for a single address.
-
The request uses a GET HTTP method with an optional
addressquery parameter. -
The response includes normalized input details for the address and a list of political geographic divisions containing the address.
-
Each division in the response includes a unique Open Civic Data identifier (OCD ID), any other valid OCD IDs, and the division's name.
Looks up political geographic divisions for a single address. Try it now .
Request
HTTP request
GET https://www.googleapis.com/civicinfo/v2/divisionsByAddress
Parameters
address
string
Request body
Don't supply a request body with this method.
Response
If successful, this method returns a response body with the following structure:
{ "kind": "civicinfo#divisionsByAddressResponse", "normalizedInput": { "locationName": string , "line1": string , "line2": string , "line3": string , "city": string , "state": string , "zip": string , }, "divisions": { key : { "name": string , "alsoKnownAs": [ string ], }, }
| Property name | Value | Description | Notes |
|---|---|---|---|
kind
|
string
|
Identifies the kind of resource. Value: the fixed string |
|
normalizedInput
|
nested object
|
The normalized version of the requested address. | |
normalizedInput.locationName
|
string
|
The name of the location. | |
normalizedInput.line1
|
string
|
The street name and number of the address. | |
normalizedInput.line2
|
string
|
The second line of the address, if needed. | |
normalizedInput.line3
|
string
|
The third line of the address, if needed. | |
normalizedInput.city
|
string
|
The city or town of the address. | |
normalizedInput.state
|
string
|
The US two letter state abbreviation of the address. | |
normalizedInput.zip
|
string
|
The US Postal Zip Code of the address. | |
divisions
|
object
|
Political geographic divisions that contain the requested address. | |
divisions.(key)
|
nested object
|
The unique Open Civic Data identifier (OCD ID) for the division. | |
divisions.(key).alsoKnownAs[]
|
list
|
Any other valid OCD IDs that refer to the same division. As OCD IDs are human-readable and predictable, there are occasionally several identifiers for a single division. These identifiers are defined to be equivalent to one another, and one is always indicated as the primary identifier. The primary identifier is returned in OCD ID, and any other equivalent valid identifiers are returned in the list. For example, if the following division's OCD ID is |
|
divisions.(key).name
|
string
|
The name of the division. |
