Geocode Address
GET {{baseUrl}}/geocode-address?address=<string>&house-number=<string>&street=<string>&city=<string>&county=<string>&state=<string>&postal-code=<string>&country-code=<string>&language-code=en&fuzzy-search=false
Geocode an address, partial address or just the name of a place
Request Params
Key | Datatype | Required | Description |
---|---|---|---|
address | string | The full address, partial address or name of a place to try and locate. Comma separated address components are preferred. | |
house-number | string | The house/building number to locate | |
street | string | The street/road name to locate | |
city | string | The city/town name to locate | |
county | string | The county/region name to locate | |
state | string | The state name to locate | |
postal-code | string | The postal code to locate | |
country-code | string | Limit result to this country (the default is no country bias) | |
language-code | string | The language to display results in, available languages are: <ul> <li>de, en, es, fr, it, pt, ru, zh</li> </ul> | |
fuzzy-search | boolean | If no matches are found for the given address, start performing a recursive fuzzy search until a geolocation is found. This option is recommended for processing user input or implementing auto-complete. We use a combination of approximate string matching and data cleansing to find possible location matches |
HEADERS
Key | Datatype | Required | Description |
---|---|---|---|
Accept | string |
RESPONSES
status: OK
{"found":-92299707,"locations":[{"country":"et Excepteur","address":"do","city":"ea in","country-code":"Ut","country-code3":"ea","latitude":-92471839.56415755,"postal-code":"deserunt con","longitude":25170689.81874457,"state":"ullamco sunt dolore","address-components":{"nisi58":"nulla aliqua occaecat m"},"currency-code":"ut ad dolor consequat","location-type":"laboris magna Lorem","location-tags":["ea qui","com"],"timezone":{"elitc7":{"id":"amet dolor","name":"laboris ali","abbr":"laborum ut","date":"est","time":"irure velit d","offset":"elit qui ullamco"}}},{"country":"cillum Duis dolor proident","address":"aute Ut sit veniam nostrud","city":"ipsum dolor","country-code":"nostrud aliquip do","country-code3":"sint et nisi cupidatat ullamco","latitude":-73881543.52579229,"postal-code":"laboris enim incididunt a","longitude":-21820684.434724405,"state":"occaecat esse fugiat","address-components":{"ad_ae":"ut amet ex","suntf9":"laborum ullamco in"},"currency-code":"aliquip","location-type":"minim ex non laboris","location-tags":["aliqua laborum","aute voluptate sunt"],"timezone":{"irure12a":{"id":"minim magna elit dolor est","name":"in ad","abbr":"veniam in anim sit dolor","date":"magna am","time":"in aliqua aute","offset":"culpa ipsum laboris in"},"ullamco1":{"id":"in commodo adipisicing laborum","name":"cillum","abbr":"non aliqua irure pariatur enim","date":"amet anim","time":"voluptate amet esse","offset":"velit mollit"}}}]}