You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: postal-codes-datasets.md
+102-98
Original file line number
Diff line number
Diff line change
@@ -10,6 +10,107 @@ modified: 2024-10-29
10
10
11
11
Postal codes are essential for various applications like mail delivery, location-based services, demographic studies, and geographic analysis. This collection brings together datasets of postal codes from different regions worldwide to support diverse use cases in both public and private sectors.
12
12
13
+
## Worldwide Postal Code Database
14
+
15
+
Simply head over to our **[Solutions page](https://datahub.io/solutions/worldwide-postal-code-database)** to explore all our offerings and find the perfect fit for your business. Enjoy accurate, worldwide postal code data that supercharges your global reach—without the complexity.
16
+
17
+
## Metadata and data samples
18
+
19
+
This schema specifies each column's name, title, description, and type, following a format compatible with the W3C's tabular data standard.
| admin_code3 | Administrative Code 3 | Code for the tertiary administrative division. | string |
32
+
| latitude | Latitude | Latitude coordinate of the place. | number |
33
+
| longitude | Longitude | Longitude coordinate of the place. | number |
34
+
| accuracy | Accuracy | Accuracy level of the latitude and longitude coordinates. | integer |
35
+
| alternativeCityName | Alternative City Name | Alternative name(s) for the city or place. | string |
36
+
37
+
### Sample data France
38
+
39
+
<FlatUiTable
40
+
data={{
41
+
"url": "https://postal.datahub.io/fr.csv"
42
+
}}
43
+
/>
44
+
45
+
## Version control and storage
46
+
47
+
We store the data in the S3 API compatible object storage which allows our users to leverage popular libraries and SDKs designed for AWS S3. For example, you can easily integrate the data into your application using boto3 for Python. There are many other alternatives for other programming languages.
48
+
49
+
Using object storage we can organize data by the date when it was gathered. While always keeping the “latest” version available with a persistent prefix, we provide the ability to look through historical versions of the data. Below is a reflection of directory (prefix) structure in our blob storage:
50
+
51
+
```bash
52
+
/postal-codes/
53
+
│
54
+
├── US/
55
+
│ ├── latest/
56
+
│ │ └── 0.csv
57
+
│ ├── 2024-10-01/
58
+
│ │ └── 0.csv
59
+
│ ├── 2024-09-01/
60
+
│ │ └── 0.csv
61
+
│ └── ...
62
+
│
63
+
├── CA/
64
+
│ ├── latest/
65
+
│ │ └── 0.csv
66
+
│ ├── 2024-10-01/
67
+
│ │ └── 0.csv
68
+
│ ├── 2024-09-01/
69
+
│ │ └── 0.csv
70
+
│ └── ...
71
+
│
72
+
├── GB/
73
+
│ ├── latest/
74
+
│ │ └── 0.csv
75
+
│ ├── 2024-10-01/
76
+
│ │ └── 0.csv
77
+
│ ├── 2024-09-01/
78
+
│ │ └── 0.csv
79
+
│ └── ...
80
+
│
81
+
└── ...
82
+
```
83
+
84
+
In this structure:
85
+
86
+
- The bucket name is `postal-codes/`.
87
+
- Each country has its own two-letter country code directory (e.g., `US/`, `CA/`, `GB/`).
88
+
- Inside each country directory, there is:
89
+
- A `latest/` folder containing the most up-to-date CSV file named `0.csv`.
90
+
- Date-named directories (`YYYY-MM-DD` format) that contain CSV files for postal codes data as it existed on those specific dates.
91
+
- Note that files are named by index for simplicity when writing a script, i.e., the first file is always `0.csv` and if there are more than a single file per country, users can expect it to be called `1.csv` and so on.
92
+
93
+
## Policy
94
+
95
+
* Country, regional, state or city level postal codes datasets depending on administrative divisions in the given country/region.
96
+
* Updated **monthly** to include new changes in postal code allocations.
97
+
98
+
## State of the World
99
+
100
+
* On a global level, open datasets for postal codes are available, but the granularity and coverage can vary. For some countries, postal code datasets include detailed location data such as state/region details, city information and so on.
101
+
* On a local level, many countries maintain official postal code datasets that are regularly updated to reflect new allocations, discontinuations, and changes in geographical boundaries.
102
+
103
+
Parameters
104
+
105
+
* Postal code
106
+
* Administrative division (city, region etc.)
107
+
* Additional metadata can be provided in a separate dataset.
108
+
109
+
## Sources
110
+
111
+
* Global sources for standard publicly available datasets.
112
+
* Country-specific sources. Please, inquire for more details.
113
+
13
114
## Catalog
14
115
15
116
<Catalog
@@ -2259,101 +2360,4 @@ Postal codes are essential for various applications like mail delivery, location
2259
2360
facets={[
2260
2361
'country'
2261
2362
]}
2262
-
/>
2263
-
2264
-
## Metadata and data samples
2265
-
2266
-
This schema specifies each column's name, title, description, and type, following a format compatible with the W3C's tabular data standard.
| admin_code3 | Administrative Code 3 | Code for the tertiary administrative division. | string |
2279
-
| latitude | Latitude | Latitude coordinate of the place. | number |
2280
-
| longitude | Longitude | Longitude coordinate of the place. | number |
2281
-
| accuracy | Accuracy | Accuracy level of the latitude and longitude coordinates. | integer |
2282
-
| alternativeCityName | Alternative City Name | Alternative name(s) for the city or place. | string |
2283
-
2284
-
### Sample data France
2285
-
2286
-
<FlatUiTable
2287
-
data={{
2288
-
"url": "https://postal.datahub.io/fr.csv"
2289
-
}}
2290
-
/>
2291
-
2292
-
## Version control and storage
2293
-
2294
-
We store the data in the S3 API compatible object storage which allows our users to leverage popular libraries and SDKs designed for AWS S3. For example, you can easily integrate the data into your application using boto3 for Python. There are many other alternatives for other programming languages.
2295
-
2296
-
Using object storage we can organize data by the date when it was gathered. While always keeping the “latest” version available with a persistent prefix, we provide the ability to look through historical versions of the data. Below is a reflection of directory (prefix) structure in our blob storage:
2297
-
2298
-
```bash
2299
-
/postal-codes/
2300
-
│
2301
-
├── US/
2302
-
│ ├── latest/
2303
-
│ │ └── 0.csv
2304
-
│ ├── 2024-10-01/
2305
-
│ │ └── 0.csv
2306
-
│ ├── 2024-09-01/
2307
-
│ │ └── 0.csv
2308
-
│ └── ...
2309
-
│
2310
-
├── CA/
2311
-
│ ├── latest/
2312
-
│ │ └── 0.csv
2313
-
│ ├── 2024-10-01/
2314
-
│ │ └── 0.csv
2315
-
│ ├── 2024-09-01/
2316
-
│ │ └── 0.csv
2317
-
│ └── ...
2318
-
│
2319
-
├── GB/
2320
-
│ ├── latest/
2321
-
│ │ └── 0.csv
2322
-
│ ├── 2024-10-01/
2323
-
│ │ └── 0.csv
2324
-
│ ├── 2024-09-01/
2325
-
│ │ └── 0.csv
2326
-
│ └── ...
2327
-
│
2328
-
└── ...
2329
-
```
2330
-
2331
-
In this structure:
2332
-
2333
-
- The bucket name is `postal-codes/`.
2334
-
- Each country has its own two-letter country code directory (e.g., `US/`, `CA/`, `GB/`).
2335
-
- Inside each country directory, there is:
2336
-
- A `latest/` folder containing the most up-to-date CSV file named `0.csv`.
2337
-
- Date-named directories (`YYYY-MM-DD` format) that contain CSV files for postal codes data as it existed on those specific dates.
2338
-
- Note that files are named by index for simplicity when writing a script, i.e., the first file is always `0.csv` and if there are more than a single file per country, users can expect it to be called `1.csv` and so on.
2339
-
2340
-
## Policy
2341
-
2342
-
* Country, regional, state or city level postal codes datasets depending on administrative divisions in the given country/region.
2343
-
* Updated **monthly** to include new changes in postal code allocations.
2344
-
2345
-
## State of the World
2346
-
2347
-
* On a global level, open datasets for postal codes are available, but the granularity and coverage can vary. For some countries, postal code datasets include detailed location data such as state/region details, city information and so on.
2348
-
* On a local level, many countries maintain official postal code datasets that are regularly updated to reflect new allocations, discontinuations, and changes in geographical boundaries.
2349
-
2350
-
Parameters
2351
-
2352
-
* Postal code
2353
-
* Administrative division (city, region etc.)
2354
-
* Additional metadata can be provided in a separate dataset.
2355
-
2356
-
## Sources
2357
-
2358
-
* Global sources for standard publicly available datasets.
2359
-
* Country-specific sources. Please, inquire for more details.
0 commit comments