Skip to content

Commit f3bbb8b

Browse files
authored
Update theme guides (#149)
* address guide updates * division guide updates * places guide updates * transportation guide updates * update address coverage image
1 parent 8fb88f6 commit f3bbb8b

File tree

6 files changed

+71
-68
lines changed

6 files changed

+71
-68
lines changed

docs/guides/addresses.mdx

+36-36
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,7 @@ import UtahAddresses from '!!raw-loader!@site/src/queries/duckdb/addresses_utah.
1616

1717
_Note: This theme is currently in Alpha. We invite the Overture community to test the addresses schema and data and offer feedback via the [data](https://github.com/OvertureMaps/data/issues) and [schema](https://github.com/OvertureMaps/schema/issues) repos._
1818

19-
Overture maintains over 400 million address point entities. Data in the address theme is derived from over 75 sources, many distributed by [OpenAddresses](https://openaddresses.io/) and [AddressForAll](https://www.addressforall.org/en/), but also includes open data from the [City of New York](https://data.cityofnewyork.us/City-Government/NYC-Address-Points/g6pj-hd8k) and the [U.S. Department of Transportation](https://www.transportation.gov/gis/national-address-database), and various public agencies.
19+
Overture maintains over 402 million address point entities. Data in the address theme is derived from over 80 sources, many distributed by [OpenAddresses](https://openaddresses.io/) and [AddressForAll](https://www.addressforall.org/en/), but also includes open data from the [City of New York](https://data.cityofnewyork.us/City-Government/NYC-Address-Points/g6pj-hd8k) and the [U.S. Department of Transportation](https://www.transportation.gov/gis/national-address-database), and various public agencies.
2020

2121
For licensing information, please see the [Attribution and Licensing page](https://docs.overturemaps.org/attribution/).
2222

@@ -29,7 +29,7 @@ Address data can be used for a variety of purposes, which can include:
2929
- **Normalization**: Adhering to standard and consistent forms of address components.
3030
- **Validation and Verification**: Confirming an address exists within a known list of addresses.
3131

32-
| ![Overture address coverage](/img/addresses/address-coverage-h3-december.png) |
32+
| ![Overture address coverage](/img/addresses/address-coverage-h3-january.png) |
3333
|:--:|
3434
| *Coverage of Overture address data, visualized using H3 cells.* |
3535

@@ -43,40 +43,40 @@ An `address` is a feature type that represents a physical place through a series
4343
<summary>Counts, per country, of the address feature type</summary>
4444
| Country | Address Count |
4545
| -------- | -------- |
46-
| AT | 2,492,155 |
47-
| AU | 15,659,449 |
48-
| BE | 6,983,401 |
49-
| BR | 89,899,299 |
50-
| CA | 16,457,788 |
51-
| CH | 3,228,673 |
52-
| CL | 4,041,876 |
53-
| CO | 7,786,046 |
54-
| CZ | 2,995,702 |
55-
| DE | 15,825,668 |
56-
| DK | 3,926,228 |
57-
| EE | 2,208,014 |
58-
| ES | 13,188,482 |
59-
| FI | 3,748,102 |
60-
| FR | 26,041,499 |
61-
| HR | 1,675,812 |
62-
| IS | ,135,026 |
63-
| IT | 9,063,974 |
64-
| JP | 19,576,027 |
65-
| LI | , 12,858 |
66-
| LT | 1,036,251 |
67-
| LU | ,164,415 |
68-
| LV | ,544,380 |
69-
| MX | 30,278,896 |
70-
| NL | 9,750,341 |
71-
| NO | 2,571,756 |
72-
| NZ | 2,365,264 |
73-
| PL | 7,669,619 |
74-
| PT | 5,676,331 |
75-
| SI | ,575,140 |
76-
| SK | 1,630,271 |
77-
| TW | 8,502,220 |
78-
| US | 84,679,173 |
79-
| UY | 1,059,695 |
46+
| AT | 2,492,155 |
47+
| AU | 15,659,449 |
48+
| BE | 6,979,299 |
49+
| BR | 89,899,299 |
50+
| CA | 17,075,427 |
51+
| CH | 3,232,976 |
52+
| CL | 4,041,876 |
53+
| CO | 7,786,046 |
54+
| CZ | 2,994,390 |
55+
| DE | 15,826,888 |
56+
| DK | 3,927,924 |
57+
| EE | 2,209,667 |
58+
| ES | 13,188,482 |
59+
| FI | 3,748,102 |
60+
| FR | 26,041,499 |
61+
| HR | 1,675,294 |
62+
| IS | ,135,299 |
63+
| IT | 9,064,100 |
64+
| JP | 19,576,027 |
65+
| LI | , 12,873 |
66+
| LT | 1,036,251 |
67+
| LU | ,164,415 |
68+
| LV | ,544,380 |
69+
| MX | 30,278,896 |
70+
| NL | 9,750,341 |
71+
| NO | 2,571,756 |
72+
| NZ | 2,367,805 |
73+
| PL | 7,669,619 |
74+
| PT | 5,676,331 |
75+
| SI | ,575,480 |
76+
| SK | 1,630,271 |
77+
| TW | 9,505,574 |
78+
| US | 84,072,091 |
79+
| UY | 1,059,695 |
8080
</details>
8181

8282
### Data columns

docs/guides/divisions.mdx

+3
Original file line numberDiff line numberDiff line change
@@ -107,6 +107,9 @@ The addresses GeoParquet file contains the following properties:
107107
| **capital_division_ids** | array | Division IDs of this division's capital divisions. If present, this property will refer to the division IDs of the capital cities, county seats, etc. of a division.
108108
| **capital_of_divisions** | list | Division ID of the division that this feature is the capital of. If present, this property will refer to the division IDs of a parent county, region, country, etc.
109109
| **division_id** | string | Division ID of the division this area belongs to.
110+
| **cartography** | array | Contains a prominence property, which offers a suggestion for displaying Overture features at specific zoom levels based on it's importance and significance.
111+
| **is_land** | boolean | Indicates whether or not the feature geometry represents the non-maritime "land" boundary, which can be used for map rendering, cartographic display, and similar purposes.
112+
| **is_territorial** | boolean | Indicates whether or not the feature geometry represents the full territorial boundary or claim of a feature.
110113
| **filename** | string | Name of the S3 file being queried.
111114
| **theme** | string | Name of the Overture theme being queried.
112115
| **type** | string | Name of the Overture feature type being queried.

docs/guides/places.mdx

+1-1
Original file line numberDiff line numberDiff line change
@@ -27,7 +27,7 @@ The Overture places theme has one feature type, called `place`, and contains mor
2727
|:--:|
2828
| *Overture places data, styled by data source: purple for Meta, orange for Microsoft.* |
2929

30-
| Primary source | Feature count, December 2024 release |
30+
| Primary source | Feature count, January 2025 release |
3131
| -------------------------- | --------------------- |
3232
| Meta | ~49.6 million |
3333
| Microsoft | ~5.9 million |

docs/guides/transportation.mdx

+31-31
Original file line numberDiff line numberDiff line change
@@ -85,38 +85,38 @@ Transportation segments are divided into three subtypes: **rail**, **water**, an
8585
<div>
8686
<Tabs>
8787
<TabItem value="classes" label="classes" default>
88-
| subtype | class | subclass | Feature count, December 2024 release |
88+
| subtype | class | subclass | Feature count, January 2025 release |
8989
|---|---|---|---|
90-
| rail | | | 1,585,021 |
91-
| road | bridleway | | 96,542 |
92-
| road | cycleway | cycle_crossing | 49,372 |
93-
| road | cycleway | | 1,216,888 |
94-
| road | footway | crosswalk | 1,921,434 |
95-
| road | footway | sidewalk | 3,083,616 |
96-
| road | footway | | 14,834,696 |
97-
| road | living_street | | 3,198,724 |
98-
| road | motorway | link | 632,849 |
99-
| road | motorway | | 432,631 |
100-
| road | path | | 12,900,432 |
101-
| road | pedestrian | | 451,802 |
102-
| road | primary | link | 472,117 |
103-
| road | primary | | 6,550,752 |
104-
| road | residential | | 124,232,135 |
105-
| road | secondary | link | 373,041 |
106-
| road | secondary | | 10,510,403 |
107-
| road | service | alley | 1,570,311 |
108-
| road | service | driveway | 15,530,080 |
109-
| road | service | parking_aisle | 6,056,973 |
110-
| road | service | | 31,950,899 |
111-
| road | steps | | 1,722,268 |
112-
| road | tertiary | link | 285,295 |
113-
| road | tertiary | | 19,321,726 |
114-
| road | track | | 24,295,660 |
115-
| road | trunk | link | 533,676 |
116-
| road | trunk | | 3,361,208 |
117-
| road | unclassified | | 28,941,961 |
118-
| road | unknown | | 643,409 |
119-
| water | | | 27,381 |
90+
| rail | | | 1,587,296 |
91+
| road | bridleway | | 96,774 |
92+
| road | cycleway | cycle_crossing | 50,097 |
93+
| road | cycleway | | 1,221,521 |
94+
| road | footway | crosswalk | 1,934,264 |
95+
| road | footway | sidewalk | 3,102,065 |
96+
| road | footway | | 14,879,098 |
97+
| road | living_street | | 3,217,422 |
98+
| road | motorway | link | 633,742 |
99+
| road | motorway | | 432,773 |
100+
| road | path | | 12,924,418 |
101+
| road | pedestrian | | 452,798 |
102+
| road | primary | link | 474,341 |
103+
| road | primary | | 6,560,174 |
104+
| road | residential | | 124,318,098 |
105+
| road | secondary | link | 374,248 |
106+
| road | secondary | | 10,523,508 |
107+
| road | service | alley | 1,575,784 |
108+
| road | service | driveway | 15,579,960 |
109+
| road | service | parking_aisle | 6,072,123 |
110+
| road | service | | 31,999,597 |
111+
| road | steps | | 1,727,022 |
112+
| road | tertiary | link | 286,181 |
113+
| road | tertiary | | 19,355,710 |
114+
| road | track | | 24,340,093 |
115+
| road | trunk | link | 536,463 |
116+
| road | trunk | | 3,368,503 |
117+
| road | unclassified | | 28,987,105 |
118+
| road | unknown | | 645,577 |
119+
| water | | | 27,399 |
120120
</TabItem>
121121
</Tabs>
122122
</div>
Binary file not shown.
Loading

0 commit comments

Comments
 (0)