February 16, 2021

Localities API Coverage

On this page you can find details on our coverage of each feature we offer within Localities API.

Available data types per feature
Available point of interest categories per feature
Address coverage per country
Rooftop supported Countries
Street number supported Countries
Street Level supported Countries
City Level supported Countries
Unsupported Countries
Specific rules regarding addresses
Specific rules regarding postal codes
City’s shape - List of supported countries

Available data types per feature

The table below summarizes the data types you can access through the different features of the Localities API.
This is a very generic information, you can find some specific rules that apply on some parts of the data in the following sections.

	Autocomplete	Search	Geocode	Nearby
address	•	FR / GB	•
locality	•	•	•
city	•	•	•
town	•	•	•
village	•	•	•
hamlet	•	•	•
borough	•	•	•
suburb	•	•	•
quarter	•	•	•
neighbourhood	•	•	•
postal_code	•	•	•
admin_level	•	•	•
country	•	•	•
point_of_interest		•		•

The types listed below are deprecated. We recommend using point_of_interest instead.

Deprecated types	Autocomplete	Geocode
airport	•	•
train_station	•	•
metro_station	•	•
shopping	•	•
museum	•	•
tourist_attraction	•	•
amusement_park	•	•
art_gallery	•	•
zoo	•	•

Available point of interest categories per feature

The table below summarizes the point of interest categories you can access through the different features of the Localities API.
This is a very generic information, you can find some specific rules that apply on some parts of the data in the following sections.

	Search	Nearby
business	•	•
business.cinema	•	•
business.theatre	•	•
business.nightclub	•	•
business.finance	•	•
business.finance.bank	•	•
business.fuel	•	•
business.parking	•	•
business.mall	•	•
business.food_and_drinks	•	•
business.food_and_drinks.bar	•	•
business.food_and_drinks.biergarten	•	•
business.food_and_drinks.cafe	•	•
business.food_and_drinks.fast_food	•	•
business.food_and_drinks.pub	•	•
business.food_and_drinks.restaurant	•	•
business.food_and_drinks.food_court	•	•
business.shop	•	•
business.shop.mall	•	•
business.shop.bakery	•	•
business.shop.butcher	•	•
business.shop.library	•	•
business.shop.grocery	•	•
business.shop.sports	•	•
business.shop.toys	•	•
business.shop.clothes	•	•
business.shop.furniture	•	•
business.shop.electronics	•	•
education	•	•
education.school	•	•
education.kindergarten	•	•
education.university	•	•
education.college	•	•
education.library	•	•
government	•	•
hospitality	•	•
hospitality.hotel	•	•
hospitality.hostel	•	•
hospitality.guest_house	•	•
hospitality.bed_and_breakfast	•	•
hospitality.motel	•	•
medical	•	•
medical.hospital	•	•
medical.pharmacy	•	•
medical.clinic	•	•
park	•	•
place_of_worship	•	•
police	•	•
post_office	•	•
sports	•	•
tourism	•	•
tourism.attraction	•	•
tourism.attraction.amusement_park	•	•
tourism.attraction.zoo	•	•
tourism.attraction.aquarium	•	•
tourism.monument	•	•
tourism.monument.castle	•	•
tourism.museum	•	•
transit	•	•
transit.station	•	•
transit.station.airport	•	•
transit.station.rail	•	•
transit.station.rail.funicular	•	•
transit.station.rail.light_rail	•	•
transit.station.rail.monorail	•	•
transit.station.rail.subway	•	•
transit.station.rail.train	•	•
transit.station.rail.tram	•	•

Address coverage per country

Woosmap Localities API offers Autocompletion, Geocoding and Reverse Geocoding on addresses worldwide.

There are different levels of coverage which vary per country. The precision level depends on the availability of the data in each country.

The following labels are used to specify the level of geocoding support in each country/region.

Rooftop: Accurate addresses along with precise X,Y coordinates on buildings rooftops
Street number: Addresses along with interpolated X,Y coordinates
Street level: Addresses are generally available but some regions might be lacking.
City level: Only major cities locations will be returned

`Rooftop` supported Countries

Country	ISO2	ISO3	Rooftop	Street number	Steet level	City level
Australia	AU	AUS	✓	✓	✓	✓
Austria	AT	AUT	✓	✓	✓	✓
Belarus	BY	BLR	✓	✓	✓	✓
Belgium	BE	BEL	✓	✓	✓	✓
Bosnia and Herzegovina	BA	BIH	✓	✓	✓	✓
Canada	CA	CAN	✓	✓	✓	✓
Chile	CL	CHL	✓	✓	✓	✓
Croatia	HR	HRV	✓	✓	✓	✓
Czech Republic	CZ	CZE	✓	✓	✓	✓
Denmark	DK	DNK	✓	✓	✓	✓
Estonia	EE	EST	✓	✓	✓	✓
Finland	FI	FIN	✓	✓	✓	✓
France	FR	FRA	✓	✓	✓	✓
Germany	DE	DEU	✓	✓	✓	✓
Gibraltar	GI	GIB	✓	✓	✓	✓
Greece	GR	GRC	✓	✓	✓	✓
Holy See (Vatican City State)	VA	VAT	✓	✓	✓	✓
Hungary	HU	HUN	✓	✓	✓	✓
Iceland	IS	ISL	✓	✓	✓	✓
Ireland	IE	IRL	✓	✓	✓	✓
Italy	IT	ITA	✓	✓	✓	✓
Latvia	LV	LVA	✓	✓	✓	✓
Liechtenstein	LI	LIE	✓	✓	✓	✓
Lithuania	LT	LTU	✓	✓	✓	✓
Luxembourg	LU	LUX	✓	✓	✓	✓
Moldova	MD	MDA	✓	✓	✓	✓
Monaco	MC	MCO	✓	✓	✓	✓
Montenegro	ME	MNE	✓	✓	✓	✓
New Zealand	NZ	NZL	✓	✓	✓	✓
Poland	PL	POL	✓	✓	✓	✓
Portugal	PT	PRT	✓	✓	✓	✓
San Marino	SM	SMR	✓	✓	✓	✓
Serbia	RS	SRB	✓	✓	✓	✓
Singapore	SG	SGP	✓	✓	✓	✓
Slovakia	SK	SVK	✓	✓	✓	✓
Slovenia	SI	SVN	✓	✓	✓	✓
Spain	ES	ESP	✓	✓	✓	✓
Sweden	SE	SWE	✓	✓	✓	✓
Switzerland	CH	CHE	✓	✓	✓	✓
The Netherlands	NL	NLD	✓	✓	✓	✓
United States of America	US	USA	✓	✓	✓	✓
Uruguay	UY	URY	✓	✓	✓	✓

`Street number` supported Countries

Country	ISO2	ISO3	Rooftop	Street number	Steet level	City level
Albania	AL	ALB	-	✓	✓	✓
Andorra	AD	AND	-	✓	✓	✓
Argentina	AR	ARG	-	✓	✓	✓
Bahamas	BS	BHS	-	✓	✓	✓
Bahrain	BH	BHR	-	✓	✓	✓
Brazil	BR	BRA	-	✓	✓	✓
Bulgaria	BG	BGR	-	✓	✓	✓
Cayman Islands	KY	CYM	-	✓	✓	✓
Cote D’Ivoire	CI	CIV	-	✓	✓	✓
French Guiana	GF	GUF	-	✓	✓	✓
Guam	GU	GUM	-	✓	✓	✓
Guernsey	GG	GGY	-	✓	✓	✓
Indonesia	ID	IDN	-	✓	✓	✓
Isle of Man	IM	IMN	-	✓	✓	✓
Jersey	JE	JEY	-	✓	✓	✓
Lesotho	LS	LSO	-	✓	✓	✓
Macedonia	MK	MKD	-	✓	✓	✓
Malta	MT	MLT	-	✓	✓	✓
Mayotte	YT	MYT	-	✓	✓	✓
Norway	NO	NOR	-	✓	✓	✓
Paraguay	PY	PRY	-	✓	✓	✓
Romania	RO	ROU	-	✓	✓	✓
Russia	RU	RUS	-	✓	✓	✓
South Africa	ZA	ZAF	-	✓	✓	✓
Swaziland	SZ	SWZ	-	✓	✓	✓
Taiwan	TW	TWN	-	✓	✓	✓
Ukraine	UA	UKR	-	✓	✓	✓
United Kingdom	GB	GBR	-	✓	✓	✓
Vietnam	VN	VNM	-	✓	✓	✓

`Street Level` supported Countries

Country	ISO2	ISO3	Rooftop	Street number	Steet level	City level
Botswana	BW	BWA	-	-	✓	✓
Brunei Darussalam	BN	BRN	-	-	✓	✓
Cambodia	KH	KHM	-	-	✓	✓
Colombia	CO	COL	-	-	✓	✓
Costa Rica	CR	CRI	-	-	✓	✓
Egypt	EG	EGY	-	-	✓	✓
Guadeloupe	GP	GLP	-	-	✓	✓
Hong Kong	HK	HKG	-	-	✓	✓
India	IN	IND	-	-	✓	✓
Israel	IL	ISR	-	-	✓	✓
Japan	JP	JPN	-	-	✓	✓
Jordan	JO	JOR	-	-	✓	✓
Kazakhstan	KZ	KAZ	-	-	✓	✓
Kenya	KE	KEN	-	-	✓	✓
Kuwait	KW	KWT	-	-	✓	✓
Lebanon	LB	LBN	-	-	✓	✓
Macau	MO	MAC	-	-	✓	✓
Malaysia	MY	MYS	-	-	✓	✓
Mexico	MX	MEX	-	-	✓	✓
Mongolia	MN	MNG	-	-	✓	✓
Morocco	MA	MAR	-	-	✓	✓
Mozambique	MZ	MOZ	-	-	✓	✓
Namibia	NA	NAM	-	-	✓	✓
Oman	OM	OMN	-	-	✓	✓
Panama	PA	PAN	-	-	✓	✓
Peru	PE	PER	-	-	✓	✓
Philippines	PH	PHL	-	-	✓	✓
Puerto Rico	PR	PRI	-	-	✓	✓
Qatar	QA	QAT	-	-	✓	✓
Rwanda	RW	RWA	-	-	✓	✓
Saudi Arabia	SA	SAU	-	-	✓	✓
Thailand	TH	THA	-	-	✓	✓
Turkey	TR	TUR	-	-	✓	✓
United Arab Emirates	AE	ARE	-	-	✓	✓
Venezuela	VE	VEN	-	-	✓	✓
Virgin Islands (U.S.)	VI	VIR	-	-	✓	✓

`City Level` supported Countries

Country	ISO2	ISO3	Rooftop	Street number	Steet level	City level
Afghanistan	AF	AFG	-	-	-	✓
Algeria	DZ	DZA	-	-	-	✓
American Samoa	AS	ASM	-	-	-	✓
Angola	AO	AGO	-	-	-	✓
Anguilla	AI	AIA	-	-	-	✓
Antigua and Barbuda	AG	ATG	-	-	-	✓
Armenia	AM	ARM	-	-	-	✓
Aruba	AW	ABW	-	-	-	✓
Azerbaijan	AZ	AZE	-	-	-	✓
Bangladesh	BD	BGD	-	-	-	✓
Barbados	BB	BRB	-	-	-	✓
Belize	BZ	BLZ	-	-	-	✓
Benin	BJ	BEN	-	-	-	✓
Bermuda	BM	BMU	-	-	-	✓
Bhutan	BT	BTN	-	-	-	✓
Bolivia	BO	BOL	-	-	-	✓
Bonaire, Sint Eustatius and Saba	BQ	BES	-	-	-	✓
Burkina Faso	BF	BFA	-	-	-	✓
Burundi	BI	BDI	-	-	-	✓
Cameroon	CM	CMR	-	-	-	✓
Cape Verde	CV	CPV	-	-	-	✓
Central African Republic	CF	CAF	-	-	-	✓
Chad	TD	TCD	-	-	-	✓
China (Mainland)	CN	CHN	-	-	-	✓
Comoros	KM	COM	-	-	-	✓
Congo	CG	COG	-	-	-	✓
Congo, The Democratic Republic of The	CD	COD	-	-	-	✓
Cook Islands	CK	COK	-	-	-	✓
Cuba	CU	CUB	-	-	-	✓
Curacao	CW	CUW	-	-	-	✓
Cyprus	CY	CYP	-	-	-	✓
Djibouti	DJ	DJI	-	-	-	✓
Dominica	DM	DMA	-	-	-	✓
Dominican Republic	DO	DOM	-	-	-	✓
Ecuador	EC	ECU	-	-	-	✓
El Salvador	SV	SLV	-	-	-	✓
Equatorial Guinea	GQ	GNQ	-	-	-	✓
Eritrea	ER	ERI	-	-	-	✓
Ethiopia	ET	ETH	-	-	-	✓
Falkland Islands (Malvinas)	FK	FLK	-	-	-	✓
Faroe Islands	FO	FRO	-	-	-	✓
Fiji	FJ	FJI	-	-	-	✓
French Polynesia	PF	PYF	-	-	-	✓
Gabon	GA	GAB	-	-	-	✓
Gambia	GM	GMB	-	-	-	✓
Georgia	GE	GEO	-	-	-	✓
Ghana	GH	GHA	-	-	-	✓
Greenland	GL	GRL	-	-	-	✓
Grenada	GD	GRD	-	-	-	✓
Guatemala	GT	GTM	-	-	-	✓
Guinea	GN	GIN	-	-	-	✓
Guinea-Bissau	GW	GNB	-	-	-	✓
Guyana	GY	GUY	-	-	-	✓
Haiti	HT	HTI	-	-	-	✓
Holy See (Vatican City State)	VA	VAT	-	-	-	✓
Honduras	HN	HND	-	-	-	✓
Iran (Islamic Republic of)	IR	IRN	-	-	-	✓
Iraq	IQ	IRQ	-	-	-	✓
Jamaica	JM	JAM	-	-	-	✓
Kiribati	KI	KIR	-	-	-	✓
Korea, Democratic People’s Republic of	KP	PRK	-	-	-	✓
Korea, Republic of	KR	KOR	-	-	-	✓
Kosovo	XK	XKX	-	-	-	✓
Kyrgyzstan	KG	KGZ	-	-	-	✓
Lao People’s Democratic Republic	LA	LAO	-	-	-	✓
Liberia	LR	LBR	-	-	-	✓
Libyan Arab Jamahiriya	LY	LBY	-	-	-	✓
Madagascar	MG	MDG	-	-	-	✓
Malawi	MW	MWI	-	-	-	✓
Maldives	MV	MDV	-	-	-	✓
Mali	ML	MLI	-	-	-	✓
Marshall Islands	MH	MHL	-	-	-	✓
Martinique	MQ	MTQ	-	-	-	✓
Mauritania	MR	MRT	-	-	-	✓
Mauritius	MU	MUS	-	-	-	✓
Micronesia, Federated States of	FM	FSM	-	-	-	✓
Montserrat	MS	MSR	-	-	-	✓
Myanmar	MM	MMR	-	-	-	✓
Nauru	NR	NRU	-	-	-	✓
Nepal	NP	NPL	-	-	-	✓
New Caledonia	NC	NCL	-	-	-	✓
Nicaragua	NI	NIC	-	-	-	✓
Niger	NE	NER	-	-	-	✓
Nigeria	NG	NGA	-	-	-	✓
Niue	NU	NIU	-	-	-	✓
Norfolk Island	NF	NFK	-	-	-	✓
Northern Mariana Islands	MP	MNP	-	-	-	✓
Pakistan	PK	PAK	-	-	-	✓
Palau	PW	PLW	-	-	-	✓
Palestinian Territory	PS	PSE	-	-	-	✓
Papua New Guinea	PG	PNG	-	-	-	✓
Reunion	RE	REU	-	-	-	✓
Saint Barthélemy	BL	BLM	-	-	-	✓
Saint Helena	SH	SHN	-	-	-	✓
Saint Kitts and Nevis	KN	KNA	-	-	-	✓
Saint Lucia	LC	LCA	-	-	-	✓
Saint Martin	MF	MAF	-	-	-	✓
Saint Pierre and Miquelon	PM	SPM	-	-	-	✓
Saint Vincent and The Grenadines	VC	VCT	-	-	-	✓
Samoa	WS	WSM	-	-	-	✓
Sao Tome and Principe	ST	STP	-	-	-	✓
Senegal	SN	SEN	-	-	-	✓
Seychelles	SC	SYC	-	-	-	✓
Sierra Leone	SL	SLE	-	-	-	✓
Sint Maarten	SX	SXM	-	-	-	✓
Solomon Islands	SB	SLB	-	-	-	✓
Somalia	SO	SOM	-	-	-	✓
South Sudan	SS	SSD	-	-	-	✓
Sri Lanka	LK	LKA	-	-	-	✓
Suriname	SR	SUR	-	-	-	✓
Svalbard and Jan Mayen Islands	SJ	SJM	-	-	-	✓
Swaziland	SZ	SWZ	-	-	-	✓
Tajikistan	TJ	TJK	-	-	-	✓
Tanzania, United Republic of	TZ	TZA	-	-	-	✓
Timor-Leste	TL	TLS	-	-	-	✓
Togo	TG	TGO	-	-	-	✓
Tokelau	TK	TKL	-	-	-	✓
Tonga	TO	TON	-	-	-	✓
Trinidad and Tobago	TT	TTO	-	-	-	✓
Tunisia	TN	TUN	-	-	-	✓
Turkmenistan	TM	TKM	-	-	-	✓
Turks and Caicos Islands	TC	TCA	-	-	-	✓
Tuvalu	TV	TUV	-	-	-	✓
Uganda	UG	UGA	-	-	-	✓
Uzbekistan	UZ	UZB	-	-	-	✓
Vanuatu	VU	VUT	-	-	-	✓
Virgin Islands (British)	VG	VGB	-	-	-	✓
Wallis and Futuna Islands	WF	WLF	-	-	-	✓
Western Sahara	EH	ESH	-	-	-	✓
Yemen	YE	YEM	-	-	-	✓
Zambia	ZM	ZMB	-	-	-	✓
Zimbabwe	ZW	ZWE	-	-	-	✓

Unsupported Countries

Country	ISO2	ISO3	Rooftop	Street number	Steet level	City level
Antarctica	AQ	ATA	-	-	-	-
British Indian Ocean Territory	IO	IOT	-	-	-	-
Pitcairn	PN	PCN	-	-	-	-
Sudan	SD	SDN	-	-	-	-
Syrian Arab Republic	SY	SYR	-	-	-	-

Specific rules regarding addresses

Country coverage

Localities autocomplete and geocode endpoints cover addresses all over the world.

You must specify countries in your requests to get the most relevant suggestions from Autocomplete endpoint. Specifying one or several components:country= is the only way to benefit from specific data sourcing Woosmap put in place in some countries:

France (French National Address DB)
United Kingdom (Royal Mail Address DB: PAF, MR and NYB data)

Accessing UK addresses specifically through Localities, to benefit from multi-residence and not-yet-built addresses, requires a specific product activation only available for Pro and Enterprise licences.

Location accuracy of UK addresses

Default location accuracy is ROOFTOP. Local specificities may exist:

Northern Ireland: postal code accuracy
Crown dependencies: postal code or district accuracy
Not Yet Built addresses: postal code or district accuracy

Specific rules regarding postal codes

The standard behavior of Localities API allows you to get postal codes in western Europe, USA and Canada. With the data=advanced parameter, you can increase the coverage of the API and search postal codes pretty much anywhere on the planet.

A dedicated option subject to specific billing on your license is needed to use this parameter. Please contact our Support Team to get it activated for your Organization.