Data Coverage
Countries #
PlacesAPI started out as a UK-specific solution but we have since expanded to more countries. We may add additional regions in the future, check back here for updates.
We currently provide location data for:
- United States
- United Kingdom
- Jersey
- Guernsey
- Isle of Man
- Republic of Ireland
Note: All records are in English. We don't provide address-level location data at this time. How far you can 'zoom in' varies from country to country but on the whole we provide locations down to zip / postal code areas.
Record IDs #
Each record has a unique identifier (the objectID field) which is always a numeric value with a two-letter country-code prefix. You can use this field to look up individual records via our REST API.
- United States example: US12731
- United Kingdom example: UK71342
- Republic of Ireland example: IE21287
Record Fields #
The following fields are available on ALL records:
| Field | Type | Description |
|---|---|---|
|
objectID |
String |
The record's unique identifier e.g. GB18343 |
|
name |
String |
The record name e.g. Guildford |
|
country |
String |
The full country name e.g. England |
|
country_code |
String |
The two-letter ISO 3166-1 country code |
|
latitude |
Float |
The latitude coordinate |
|
longitude |
Float |
The longitude coordinate |
|
easting |
Integer |
The easting coordinate |
|
northing |
Integer |
The northing coordinate |
|
importance |
Integer |
The importance of the place (used for additional ranking weight) |
The following fields will vary depending on the country:
| Field | Type | Description |
|---|---|---|
|
type |
String |
The record type city, town, military city, town, village, hamlet, locality, suburban area townland, town/village, city |
|
county |
String |
The county name e.g. Surrey Not Jersey Not Guernsey |
|
postcode |
String |
Zip code(s) Partial postcode area e.g. GU1 4 Eircode |
|
us_state |
String |
The US state e.g. Florida US only |
|
us_state_code |
String |
The US state code e.g. FL US only |
|
region |
String |
The region name e.g. South East Not US |
|
gov_area |
String |
The government area e.g. Dublin City Council Not US |
|
grid_ref |
String |
The grid reference Not US |
|
elevation |
Integer |
The height above sea level in metres UK only |
|
irish_name |
String |
The record's Irish name e.g. Baile Átha Cliath Republic of Ireland only |
|
irish_postal_town |
String |
The postal town e.g. Dublin Republic of Ireland only |
|
irish_province |
String |
The Irish province name e.g. Leinster. Republic of Ireland only |