Generate a list of all U.S. ZIP Codes up to a radius distance of 200 miles around a central target ZIP Code. Also obtain latitude, longitude, and distance from the target for each ZIP Code in the radius area.
Request Details
Example Request Url
https://geodata.cdxtech.com/api/georadius?key={key}&zipcode={zipcode}&milage={milage}&format={format}
Description | Required | Default Value | Example | |
key | Authentication Key | key=dd76pxfi4feydh4bz_dtrjyf6flu4-987asdjhajkd555usds28ad984yhz | ||
zipcode | Zipcode Reference | zipcode=07869 | ||
mileage | Miles from radius | mileage=5 | ||
distanceUnit | Distance measurement | miles | distanceunit=miles (supported distanceUnits: miles, kilometers, nauticalmiles) | |
format | Output Formatting | json | format=json (supported formats: json, xml, csv) |
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 zipCode = "07869";
string mileage = "3";
string format = "json";
using (HttpClient client = new HttpClient())
{
client.BaseAddress = new Uri("https://geodata.cdxtech.com");
StringBuilder url = new StringBuilder("/api/georadius?");
url.Append("key=").Append(key);
url.Append("&zipcode=").Append(zipCode);
url.Append("&mileage=").Append(mileage);
url.Append("&format=").Append(format);
message = client.GetAsync(url.ToString()).Result;
}
import requests
def get_georadius(api_key, zipcode, mileage, response_format="json"):
"""Fetch radius-based distance data using the API."""
base_url = "https://geodata.cdxtech.com"
endpoint = "/api/georadius"
url = f"{base_url}{endpoint}"
params = {
"key": api_key,
"zipcode": zipcode,
"mileage": mileage,
"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}"
zipcode = "07869"
mileage = "3"
fmt = "json"
data = get_georadius(key, zipcode, mileage, 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_georadius(
api_key: &str,
zipcode: &str,
mileage: &str,
response_format: &str,
) -> Result> {
let client = reqwest::blocking::Client::new();
let resp = client
.get("https://geodata.cdxtech.com/api/georadius")
.query(&[
("key", api_key),
("zipcode", zipcode),
("mileage", mileage),
("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 zipcode = "07869";
let mileage = "3";
let fmt = "json";
match get_georadius(api_key, zipcode, mileage, fmt) {
Ok(data) => println!("Response JSON:\n{}", serde_json::to_string_pretty(&data)?),
Err(err) => eprintln!("Error fetching data: {}", err),
}
Ok(())
}
async function getGeoradius({ key, zipcode, mileage, format = "json" }) {
const baseUrl = "https://geodata.cdxtech.com";
const endpoint = "/api/georadius";
const params = new URLSearchParams({ key, zipcode, mileage, 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 zipcode = "07869";
const mileage = "3";
const format = "json";
try {
const data = await getGeoradius({ key, zipcode, mileage, format });
console.log("Response:", data);
} catch (err) {
console.error("Error fetching data:", err);
}
})();
Dim key As String = "{your-key}"
Dim zipcode As String = "07869"
Dim mileage As String = "3"
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/georadius?")
url.Append("key=").Append(key)
url.Append("&zipcode=").Append(zipCode)
url.Append("&mileage=").Append(mileage)
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 zipcode As String
Dim mileage As String
Dim format As String
key = "{your-key}"
zipcode = "07869"
mileage = "3"
format = "json"
Client.BaseUrl = "https://geodata.cdxtech.com/api/"
Request.Method = WebMethod.HttpGet
Request.ResponseFormat = WebFormat.Json
Request.Resource = "georadius?key={key}&zipcode={zipCode}&mileage={mileage}&format={format}"
Request.AddUrlSegment "key", key
Request.AddUrlSegment "zipCode", zipcode
Request.AddUrlSegment = "mileage", mileage
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": "GeoRadius",
"url": "https://geodata.cdxtech.com/api/georadius?key={your-key}&zipcode=07869&mileage=3&format=json",
"status": "Success",
"tokenCharge": 3,
"message": null,
"totalResults": 4,
"results": [{
"coordinates": {
"zipCode": "07869",
"latitude": 40.842115,
"longitude": -74.58229
},
"distance": 0.0,
"distanceUnit": "miles"
},
{
"coordinates": {
"zipCode": "07970",
"latitude": 40.810961,
"longitude": -74.575269
},
"distance": 2.1835,
"distanceUnit": "miles"
},
{
"coordinates": {
"zipCode": "07845",
"latitude": 40.8225,
"longitude": -74.6264
},
"distance": 2.6746,
"distanceUnit": "miles"
},
{
"coordinates": {
"zipCode": "07803",
"latitude": 40.880137,
"longitude": -74.600716
},
"distance": 2.7978,
"distanceUnit": "miles"
}],
"usage": {
"used": 100,
"remaining": 1000
},
"duration": 0.3449712,
"timeStamp": "2017-02-02T12:09:46.6319649-05:00"
}
<Root>
<Service>GeoRadius</Service>
<Url>https://geodata.cdxtech.com/api/georadius?key={your-key}&zipcode=07869&mileage=3&format=xml</Url>
<Status>Success</Status>
<TokenCharge>3</TokenCharge>
<Message />
<TotalResults>4</TotalResults>
<Results>
<Coordinates>
<ZipCode>07869</ZipCode>
<Latitude>40.842115</Latitude>
<Longitude>-74.58229</Longitude>
</Coordinates>
<Distance>0</Distance>
<DistanceUnit>miles</DistanceUnit>
</Results>
<Results>
<Coordinates>
<ZipCode>07970</ZipCode>
<Latitude>40.810961</Latitude>
<Longitude>-74.575269</Longitude>
</Coordinates>
<Distance>2.1835</Distance>
<DistanceUnit>miles</DistanceUnit>
</Results>
<Results>
<Coordinates>
<ZipCode>07845</ZipCode>
<Latitude>40.8225</Latitude>
<Longitude>-74.6264</Longitude>
</Coordinates>
<Distance>2.6746</Distance>
<DistanceUnit>miles</DistanceUnit>
</Results>
<Results>
<Coordinates>
<ZipCode>07803</ZipCode>
<Latitude>40.880137</Latitude>
<Longitude>-74.600716</Longitude>
</Coordinates>
<Distance>2.7978</Distance>
<DistanceUnit>miles</DistanceUnit>
</Results>
<Usage>
<Used>100</Used>
<Remaining>1000</Remaining>
</Usage>
<Duration>0.3692129</Duration>
<TimeStamp>2017-02-02T12:09:49.9879674-05:00</TimeStamp>
</Root>