Geocode a locality or Reverse Geocode a latlng
GET
https://api.woosmap.com/localities/geocode
Provides details for an address or a geographic position. Either parameter address or latlng is required.
Authorization
Query Parameters
address
string
latlng
string
types
string Defaults to
locality|postal_code|address excluded_types
string
list_sub_buildings
boolean
components
string
language
string
fields
string
data
string
cc_format
string
Response
Request Localities Geocode successful
results
object[]
Show 10 propertiesHide 10 properties
Show 4 propertiesHide 4 properties
Show 2 propertiesHide 2 properties
Show 2 propertiesHide 2 properties
Show 3 propertiesHide 3 properties
Show 2 propertiesHide 2 properties
Show 3 propertiesHide 3 properties
curl -L 'https://api.woosmap.com/localities/geocode?address=Place%20Jeanne-d%27Arc&components=country%3AFR&key=YOUR_PUBLIC_API_KEY' \
-H 'Referer: http://localhost'
const requestOptions = {
method: "GET",
redirect: "follow"
};
fetch("https://api.woosmap.com/localities/geocode?address=Place%20Jeanne-d'Arc&components=country%3AFR&key=YOUR_PUBLIC_API_KEY", requestOptions)
.then((response) => response.text())
.then((result) => console.log(result))
.catch((error) => console.error(error));
import requests
url = "https://api.woosmap.com/localities/geocode?address=Place%20Jeanne-d'Arc&components=country%3AFR&key=YOUR_PUBLIC_API_KEY"
payload = {}
headers = {
'Referer': 'http://localhost'
}
response = requests.request("GET", url, headers=headers, data=payload)
print(response.text)
{ "results": [ { "public_id": "0+FTYd/1MsiBSxLAKq+/Fiyy+uM=", "types": [ "address", "route" ], "formatted_address": "Place Jeanne D'Arc, 75013, Paris", "address_components": [ { "types": [ "country", "administrative_area_level_0", "division_level_0" ], "long_name": "France", "short_name": "FR" }, { "types": [ "state", "division_level_1" ], "long_name": "Île-de-France", "short_name": "Île-de-France" }, { "types": [ "administrative_area_level_1", "county", "division_level_2" ], "long_name": "Paris", "short_name": "Paris" }, { "types": [ "locality" ], "long_name": "Paris", "short_name": "Paris" }, { "types": [ "postal_codes" ], "long_name": "75013", "short_name": "75013" }, { "types": [ "route" ], "long_name": "Place Jeanne D'Arc", "short_name": "Place Jeanne D'Arc" } ], "geometry": { "location": { "lat": 48.829405, "lng": 2.367944 }, "location_type": "GEOMETRIC_CENTER" }, "scores_per_components": { "street_name": 1 } } ] }
{ "results": [ { "public_id": "", "types": [ "address" ], "formatted_address": "Radway House, Alfred Road, London, W2 5ER", "address_components": [ { "types": [ "country", "administrative_area_level_0", "division_level_0" ], "long_name": "United Kingdom", "short_name": "GB" }, { "types": [ "state", "division_level_1" ], "long_name": "England", "short_name": "England" }, { "types": [ "administrative_area_level_1", "county", "division_level_2" ], "long_name": "City of London", "short_name": "City of London" }, { "types": [ "district", "division_level_3" ], "long_name": "Westminster", "short_name": "Westminster" }, { "types": [ "locality" ], "long_name": "London", "short_name": "London" }, { "types": [ "postal_codes" ], "long_name": "W2 5ER", "short_name": "W2 5ER" }, { "types": [ "route" ], "long_name": "Alfred Road", "short_name": "Alfred Road" }, { "types": [ "premise" ], "long_name": "Radway House", "short_name": "Radway House" } ], "geometry": { "location": { "lat": 51.5211258, "lng": -0.1956346 }, "location_type": "ROOFTOP" }, "distance": 28.62347934634507, "sub_buildings": [ { "public_id": "Nmp0K1VVUFQ4eFI3S1BuaDZEZVVJVWhYY3A4PV9faitia1pNNURnOWYvQmRjMUdweXl5SjdLZUZnPQ==", "description": "Flat 1, Radway House, Alfred Road, London, W2 5ER" }, { "public_id": "Nmp0K1VVUFQ4eFI3S1BuaDZEZVVJVWhYY3A4PV9fbTRoZVpxYkhBYVVXSytqek04UGtGQ1VLTVI0PQ==", "description": "Flat 2, Radway House, Alfred Road, London, W2 5ER" }, { "public_id": "Nmp0K1VVUFQ4eFI3S1BuaDZEZVVJVWhYY3A4PV9fcmY1MHV6aE5kVytLWWZLV3JabzFzR2lnbThzPQ==", "description": "Flat 3, Radway House, Alfred Road, London, W2 5ER" }, { "public_id": "Nmp0K1VVUFQ4eFI3S1BuaDZEZVVJVWhYY3A4PV9fajlaWXJJUDFKSmI1Y0dpNElDanBQejF2YUg4PQ==", "description": "Flat 4, Radway House, Alfred Road, London, W2 5ER" }, { "public_id": "Nmp0K1VVUFQ4eFI3S1BuaDZEZVVJVWhYY3A4PV9fbkdEZTNOODZNL0VlWGtoR0pSa2tBS1NMYndVPQ==", "description": "Flat 5, Radway House, Alfred Road, London, W2 5ER" }, { "public_id": "Nmp0K1VVUFQ4eFI3S1BuaDZEZVVJVWhYY3A4PV9fTGxlWUlKN2NhU1JXcTBuSEs1RExiamliNlpNPQ==", "description": "Flat 6, Radway House, Alfred Road, London, W2 5ER" }, { "public_id": "Nmp0K1VVUFQ4eFI3S1BuaDZEZVVJVWhYY3A4PV9feVZXa05ISjhzVGNHK2NQUHFpNlFIUWgvSnpJPQ==", "description": "Flat 7, Radway House, Alfred Road, London, W2 5ER" }, { "public_id": "Nmp0K1VVUFQ4eFI3S1BuaDZEZVVJVWhYY3A4PV9fTVc5NldSeWpuOENUS2xST21vZzdnNGxGQldrPQ==", "description": "Flat 8, Radway House, Alfred Road, London, W2 5ER" }, { "public_id": "Nmp0K1VVUFQ4eFI3S1BuaDZEZVVJVWhYY3A4PV9fN3RkdE9HeHBwT2M5R1hQMUFwNDJUc3NwRklZPQ==", "description": "Flat 9, Radway House, Alfred Road, London, W2 5ER" }, { "public_id": "Nmp0K1VVUFQ4eFI3S1BuaDZEZVVJVWhYY3A4PV9fR2RVRHpoYll4a2RlTldjLzF3NVNFTXNZYzlFPQ==", "description": "Flat 10, Radway House, Alfred Road, London, W2 5ER" }, { "public_id": "Nmp0K1VVUFQ4eFI3S1BuaDZEZVVJVWhYY3A4PV9fL3FXbnVZU2h4bjAwMDNKK3hJeU9OL3lnemFzPQ==", "description": "Flat 11, Radway House, Alfred Road, London, W2 5ER" }, { "public_id": "Nmp0K1VVUFQ4eFI3S1BuaDZEZVVJVWhYY3A4PV9fVVVCUWhpNVJQWWk2eTl1WFBTVTRmK3Zma3VBPQ==", "description": "Flat 12, Radway House, Alfred Road, London, W2 5ER" }, { "public_id": "Nmp0K1VVUFQ4eFI3S1BuaDZEZVVJVWhYY3A4PV9fV2hSUDNadnFMN3ZzaWJ6UFd2MWM3aW1qT3hBPQ==", "description": "Flat 13, Radway House, Alfred Road, London, W2 5ER" }, { "public_id": "Nmp0K1VVUFQ4eFI3S1BuaDZEZVVJVWhYY3A4PV9fcWxGbFRlcE1TVStZVElodzFSdVhiTGxZTXl3PQ==", "description": "Flat 14, Radway House, Alfred Road, London, W2 5ER" }, { "public_id": "Nmp0K1VVUFQ4eFI3S1BuaDZEZVVJVWhYY3A4PV9fYjR5VHRXMmZTQ0FOMGwwZHJNaFh5TFRnVHlnPQ==", "description": "Flat 15, Radway House, Alfred Road, London, W2 5ER" }, { "public_id": "Nmp0K1VVUFQ4eFI3S1BuaDZEZVVJVWhYY3A4PV9fNmp0K1VVUFQ4eFI3S1BuaDZEZVVJVWhYY3A4PQ==", "description": "Flat 16, Radway House, Alfred Road, London, W2 5ER" } ] } ] }
{ "detail": "Incorrect authentication credentials. Please check or use a valid API Key" }
{ "detail": "This Woosmap API is not enabled for this project." }
{ "detail": "The rate limit for this endpoint has been exceeded" }