Geocode
GET
https://api.woosmap.com/localities/geocode
Geocodes an address into coordinates, or reverse geocodes a latlng position into an address. Provide exactly one of address or latlng.
Ratelimit: 50/1s
Authorization
Header Parameters
accept-language
string
Query Parameters
fields
string Defaults to
geometry|address_components language
string Defaults to
"" cc_format
CountryCodeFormat
data
string Defaults to
standard components
string
types
LocalitiesTypes | LocalitiesTypesPoi | LocalitiesTypesPoiAlias Defaults to
locality|postal_code|address excluded_types
LocalitiesTypes | LocalitiesTypesPoi | LocalitiesTypesPoiAlias
address
string
latlng
string
list_sub_buildings
boolean Defaults to
false Response
Successful Response
Any of
Localities Geocode Collection Response. Contains one or more detailed Localities or Addresses in FR or in the UK, with coordinates (default to one result for reverse geocoding)
results
object[] required
Show 9 propertiesHide 9 properties
Show 3 propertiesHide 3 properties
Show 4 propertiesHide 4 properties
Show 2 propertiesHide 2 properties
Show 2 propertiesHide 2 properties
Localities Geocode Collection Response. Contains one or more detailed Localities or Addresses in FR or in the UK, with coordinates (default to one result for reverse geocoding)
results
object[] required
Show 10 propertiesHide 10 properties
Show 3 propertiesHide 3 properties
Show 4 propertiesHide 4 properties
Show 2 propertiesHide 2 properties
Show 2 propertiesHide 2 properties
Show 2 propertiesHide 2 properties
Errors
401
Unable to locate credentials.
application/json
detail
string required
402
Out of free quota.
application/json
detail
string required
403
Credentials found, but not matching.
application/json
detail
string required
422
Validation Error
429
Rate limit reached
application/json
detail
string required
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" } ] } ] }