Geocode (get latitude and longitude from addresses) and reverse geocode (get addresses from latitude and longitude). Data is sourced from Bing Maps, which provide address or rooftop geocoding precision.
Request Details
Example Request Url
https://geodata.cdxtech.com/api/geolocateaddress?key={key}&query={query}&format={format}
Description | Required | Default Value | Example | |
key | Authentication Key | key=dd76pxfi4feydh4bz_dtrjyf6flu4-987asdjhajkd555usds28ad984yhz | ||
address | Single line address | address=2 West Hanover Ave 07869 | ||
city | City or neighborhood | city=randolph | ||
state | State abbreviation | state=nj | ||
zipcode | 5 digit zip code | zipcode=07869 | ||
country | ISO country code | country=us | ||
format | Output Formatting | json | format=json (supported formats: json, xml) |
Coding Examples
Here are some coding examples to get you started. Please feel free to contact support if you need additional assistance.
string key = "{your-key}";
string address = "2 West Hanover Ave Randolph 07869"
string city = "randolph";
string state = "nj";
string zipcode = "07869";
string country = "us";
string format = "json";
HttpResponseMessage message = null;
using (HttpClient client = new HttpClient())
{
client.BaseAddress = new Uri("https://geodata.cdxtech.com");
StringBuilder url = new StringBuilder("/api/geolocateaddress?");
url.Append("key=").Append(key);
url.Append("&address=").Append(address);
url.Append("&city=").Append(city);
url.Append("&state=").Append(state);
url.Append("&zipcode=").Append(zipcode);
url.Append("&country=").Append(country);
url.Append("&format=").Append(format);
message = client.GetAsync(url.ToString()).Result;
}
import requests
def get_geolocateaddress(api_key, address, city, state, zipcode, country, response_format="json"):
"""Fetch address geolocation using the API."""
base_url = "https://geodata.cdxtech.com"
endpoint = "/api/geolocateaddress"
url = f"{base_url}{endpoint}"
params = {
"key": api_key,
"address": address,
"city": city,
"state": state,
"zipcode": zipcode,
"country": country,
"format": response_format,
}
response = requests.get(url, params=params)
response.raise_for_status()
try:
return response.json()
except ValueError:
return response.text
if __name__ == "__main__":
key = "{your-key}"
address = "2 West Hanover Ave Randolph 07869"
city = "randolph"
state = "nj"
zipcode = "07869"
country = "us"
fmt = "json"
data = get_geolocateaddress(key, address, city, state, zipcode, country, fmt)
import json
if isinstance(data, (dict, list)):
print(json.dumps(data, indent=2))
else:
print(data)
// Cargo.toml
// [dependencies]
// reqwest = { version = "0.11", features = ["blocking", "json"] }
// serde = { version = "1.0", features = ["derive"] }
// serde_json = "1.0"
use std::error::Error;
fn get_geolocateaddress(
api_key: &str,
address: &str,
city: &str,
state: &str,
zipcode: &str,
country: &str,
response_format: &str,
) -> Result> {
let client = reqwest::blocking::Client::new();
let resp = client
.get("https://geodata.cdxtech.com/api/geolocateaddress")
.query(&[
("key", api_key),
("address", address),
("city", city),
("state", state),
("zipcode", zipcode),
("country", country),
("format", response_format),
])
.send()?
.error_for_status()?;
let json: serde_json::Value = resp.json()?;
Ok(json)
}
fn main() -> Result<(), Box> {
let api_key = "{your-key}";
let address = "2 West Hanover Ave Randolph 07869";
let city = "randolph";
let state = "nj";
let zipcode = "07869";
let country = "us";
let fmt = "json";
match get_geolocateaddress(api_key, address, city, state, zipcode, country, fmt) {
Ok(data) => println!("Response JSON:\n{}", serde_json::to_string_pretty(&data)?),
Err(err) => eprintln!("Error fetching data: {}", err),
}
Ok(())
}
async function getGeolocateAddress({ key, address, city, state, zipcode, country, format = "json" }) {
const baseUrl = "https://geodata.cdxtech.com";
const endpoint = "/api/geolocateaddress";
const params = new URLSearchParams({ key, address, city, state, zipcode, country, format });
const url = `${baseUrl}${endpoint}?${params.toString()}`;
const response = await fetch(url);
if (!response.ok) {
throw new Error(`HTTP error! Status: ${response.status}`);
}
const text = await response.text();
try {
return JSON.parse(text);
} catch {
return text;
}
}
// Example usage:
(async () => {
const key = "{your-key}";
const address = "2 West Hanover Ave Randolph 07869";
const city = "randolph";
const state = "nj";
const zipcode = "07869";
const country = "us";
const format = "json";
try {
const data = await getGeolocateAddress({ key, address, city, state, zipcode, country, format });
console.log("Response:", data);
} catch (err) {
console.error("Error fetching data:", err);
}
})();
Dim key As String = "{your-key}"
Dim address = "2 West Hanover Ave"
Dim city = "Randolph"
Dim state = "nj"
Dim zipcode = "07869"
Dim format As String = "json"
Dim message As HttpResponseMessage = Nothing
Using client As New HttpClient()
client.BaseAddress = New Uri("https://geodata.cdxtech.com")
Dim url As New StringBuilder("/api/geolocateaddress?")
url.Append("key=").Append(key)
url.Append("&address=").Append(address)
url.Append("&city=").Append(city)
url.Append("&state=").Append(state)
url.Append("&zipcode=").Append(zipcode)
url.Append("&format=").Append(format)
message = client.GetAsync(url.ToString()).Result
End Using
The following is for the VBA-WEB Excel template available at http://vba-tools.github.io/VBA-Web/
Dim Client As New WebClient
Dim Request As New WebRequest
Dim key As String
Dim address AS String
Dim city As String
Dim state As String
Dim zipcode As String
Dim format As String
key = "{your-key}"
address = "2 West Hanover Ave"
city = "Randolph"
state = "nj"
zipcode = "07869"
format = "json"
Client.BaseUrl = "https://geodata.cdxtech.com/api/"
Request.Method = WebMethod.HttpGet
Request.ResponseFormat = WebFormat.Json
Request.Resource = "geolocateaddress?key={key}&address={address}&city={city}&state={state}&zipcode={zipcode}&format={format}"
Request.AddUrlSegment "key", key
Request.AddUrlSegment "address", address
Request.AddUrlSegment "city", city
Request.AddUrlSegment "state", state
Request.AddUrlSegment "zipcode", zipcode
Request.AddUrlSegment "format", format
Set Response = Client.Execute(Request)
Output Examples
Here are some output data examples. You can also use the Report Generator tab to export specific data files.
{
"service": "GeoLocateAddress",
"url": "https://geodata.cdxtech.com/api/geolocateaddress?key={your-key}&address=2%20West%20Hanover%20Ave&city=randolph&state=nj&zipCode=07869&country=&format=json",
"status": "Success",
"tokenCharge": 2,
"message": null,
"totalResults": 1,
"results": [{
"formattedAddress": "2 W Hanover Ave, Randolph, NJ 07869",
"streetAddress": "2 W Hanover Ave",
"city": "Randolph",
"county": "Morris",
"state": "NJ",
"zipCode": "07869",
"country": "United States",
"latitude": 40.82653,
"longitude": -74.56786,
"confidence": "High"
}],
"usage": {
"used": 2611,
"usedPercentage": 1.322768746,
"remaining": 197389,
"remainingPercentage": 98.677231254
},
"duration": 0.2174606,
"timeStamp": "2017-07-24T10:15:38.9590633-04:00"
}
<Root>
<Service>GeoLocateAddress</Service>
<Url>https://geodata.cdxtech.com/api/geolocateaddress?key={your-key}&address=2%20West%20Hanover%20Ave&city=randolph&state=nj&zipCode=07869&country=&format=xml</Url>
<Status>Success</Status>
<TokenCharge>2</TokenCharge>
<Message />
<TotalResults>1</TotalResults>
<Results>
<FormattedAddress>2 W Hanover Ave, Randolph, NJ 07869</FormattedAddress>
<StreetAddress>2 W Hanover Ave</StreetAddress>
<City>Randolph</City>
<County>Morris</County>
<State>NJ</State>
<ZipCode>07869</ZipCode>
<Country>United States</Country>
<Latitude>40.82653</Latitude>
<Longitude>-74.56786</Longitude>
<Confidence>High</Confidence>
</Results>
<Usage>
<Used>2613</Used>
<UsedPercentage>1.323795387</UsedPercentage>
<Remaining>197387</Remaining>
<RemainingPercentage>98.676204613</RemainingPercentage>
</Usage>
<Duration>0.21519629999999998</Duration>
<TimeStamp>2017-07-24T10:15:40.1231598-04:00</TimeStamp>
</Root>