Geocodes an address, converting address to coordinates.
This endpoint is best for complete addresses. For partial addresses or place names, call the autocomplete endpoint instead.
Returns a confidence level, as defined below:
exact: The result matches the query sent.
interpolated: A result where there is a record for the street but not the exact building number, so the value is calculated between two known building numbers.
fallback: A result where MuniApps does not have a matching record and cannot interpolate the results. MuniApps falls back to the region containing the query.
Definitions
GET https://muniapps.org/api/geofwd/
Query parameters
query (string, required): The address to geocode.
Authentication level
Required (not available with free services)
Default rate limit
100 requests per second
Sample request
https://muniapps.org/api/geofwd/
Sample response
{
"meta": {
"code": 200
},
"addresses": [
{
"latitude": 40.7041,
"longitude": -73.9867,
"geometry": {
"type": "Point",
"coordinates": [-73.9867,40.7041]
},
"country": "United States",
"countryCode": "US",
"countryFlag": "🇺🇸",
"county": "Kings County",
"confidence": "exact",
"borough": "Brooklyn",
"city": "Brooklyn",
"number": "20",
"neighborhood": "DUMBO",
"postalCode": "11201",
"stateCode": "NY",
"state": "New York",
"street": "Jay St",
"layer": "address",
"formattedAddress": "20 Jay St, Brooklyn, New York, NY 11201 USA",
"addressLabel": "20 Jay St",
"timeZone": {
"id": "America/New_York",
"name": "Eastern Daylight Time",
"code": "EDT",
"currentTime": "2024-04-09T10:12:00-04:00",
"utcOffset": -14400,
"dstOffset": 3600
}
}
]
}
Reverse geocodes a location, converting coordinates to address.
Definitions
GET https://muniapps.org/api/geocode/reverse
Query parameters
coordinates (string, required): The coordinates to reverse geocode. A string in the format latitude,longitude.
Authentication level
Required (not available with free services)
Default rate limit
100 requests per second
Sample request
https://muniapps.org/api/georev/
Sample responses
{
"meta": {
"code": 200
},
"addresses": [
{
"latitude": 40.70390,
"longitude": -73.98670,
"geometry": {
"type": "Point",
"coordinates": [-73.98670, 40.70390]
},
"addressLabel": "20 Jay Street",
"formattedAddress": "20 Jay Street, Brooklyn, New York, NY 11201 USA",
"country": "United States",
"countryCode": "US",
"countryFlag": "🇺🇸",
"state": "New York",
"stateCode": "NY",
"postalCode": "11201",
"city": "New York",
"borough": "Brooklyn",
"county": "Kings County",
"neighborhood": "DUMBO",
"timeZone": {
"id": "America/New_York",
"name": "Eastern Daylight Time",
"code": "EDT",
"currentTime": "2024-04-09T10:12:00-04:00",
"utcOffset": -14400,
"dstOffset": 3600
},
"number": "20",
"distance": 5,
"layer": "address"
}
]
}
Geocodes the requester's IP, converting IP address to city, state, and country.
Definitions
GET https://muniapps.org/api/geoloc/
Authentication level
None (available with free services)
Default rate limit
100 requests per second per device
Sample request
https://muniapps.org/api/geoloc/
Sample response
{
"meta": {
"code": 200
},
"address": {
"latitude": 40.70390,
"longitude": -73.98670,
"geometry": {
"type": "Point",
"coordinates": [-73.98670, 40.70390]
},
"country": "United States",
"countryCode": "US",
"countryFlag": "🇺🇸",
"state": "New York",
"stateCode": "NY",
"postalCode": "11201",
"city": "New York",
"timeZone": {
"id": "America/New_York",
"name": "Eastern Daylight Time",
"code": "EDT",
"currentTime": "2024-04-09T10:12:00-04:00",
"utcOffset": -14400,
"dstOffset": 3600
},
},
"proxy": false,
"ip": "107.77.199.117"
}