Add a place types page (#390)

* add place types page * add links to place types page * fix broken links * make place_types sentence case
datacommonsorg · May 1, 2024 · 6c22fb0 · 6c22fb0
1 parent 4d5bf51
commit 6c22fb0
Show file tree

Hide file tree

Showing 11 changed files with 112 additions and 10 deletions.
diff --git a/api/python/place_in.md b/api/python/place_in.md
@@ -28,7 +28,7 @@ Going into more detail on how to assemble the values for the required arguments:
 
  - `dcids`: Data Commons uniquely identifies nodes by assigning them DCIDs, or Data Commons IDs. Your query will need to specify the DCIDs for the nodes of interest. More information about DCIDs is available in [the glossary](/glossary.html).
 
- - `place_type`: This argument specifies the type of place sought in the response. For example, when examining places contained within American `States`, you would be able to select `City` or `County` (among others). For a full list of available types, see [`subClassOf Place`](https://datacommons.org/browser/Place).
+ - `place_type`: This argument specifies the type of place sought in the response. For example, when examining places contained within American `States`, you would be able to select `City` or `County` (among others). For a full list of available types, see [the place types page](/place_types.html).
 
 ## What to expect in the function return
 

diff --git a/api/sheets/places_in.md b/api/sheets/places_in.md
@@ -21,7 +21,7 @@ The `=DCPLACESIN(dcids, placeType)` formula returns lists of child places from a
 ## Required Arguments
 
 * `dcids`: A list of parent [Place](/glossary.html#place) nodes, identified by their [DCIDs](/glossary.html#dcid).
-* `placeType`: The type of the contained child `Place` nodes to filter by. For example,`City` and `County`are contained within `State`. For a full list of available types, see [the Data Commons graph browser entry for Place](https://datacommons.org/browser/Place).
+* `placeType`: The type of the contained child `Place` nodes to filter by. For example,`City` and `County`are contained within `State`. For a full list of available types, see the [place types page](/place_types.html).
 
 ## Returns
 

diff --git a/api/web_components/bar.md b/api/web_components/bar.md
@@ -55,7 +55,7 @@ permalink: /api/web_components/bar
 
 | Name           | Type   | Description                                                                                                                                                                                   |
 | -------------- | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| childPlaceType | string | Child place types to plot. Example: `State`. <br /> <optional-tag>Optional</optional-tag> if `places` is specified.                                                                           |
+| childPlaceType | string | Child place types to plot. Example: `State`. For a list of available place types, see the [place types page](/place_types.html).<br /><optional-tag>Optional</optional-tag> if `places` is specified.                                                                           |
 | header         | string | Chart title.                                                                                                                                                                                  |
 | parentPlace    | string | Parent place [DCID](/glossary.html#dcid) to plot. Example: `country/USA`. <br /> <optional-tag>Optional</optional-tag> if `places` is specified.                                                                     |
 | places         | list   | Places [DCID](/glossary.html#dcid)s to plot, as a space separated list of strings. Example: `"geoId/12 geoId/13"`. <br /> <optional-tag>Optional</optional-tag> if `childPlaceType` and `parentPlace` are specified. |

diff --git a/api/web_components/line.md b/api/web_components/line.md
@@ -51,7 +51,7 @@ permalink: /api/web_components/line
 
 | Name           | Type   | Description                                                                                                                                                                                                          |
 | -------------- | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| childPlaceType | string | Child place types to plot. Example: `State`. <br /> <optional-tag>Optional</optional-tag> if `places` is specified.                                                                                                  |
+| childPlaceType | string | Child place types to plot. Example: `State`. For a list of available place types, see the [place types page](/place_types.html).<br /> <optional-tag>Optional</optional-tag> if `places` is specified.                                                                                                  |
 | header         | string | Chart title.                                                                                                                                                                                                         |
 | parentPlace    | string | Parent place [DCID](/glossary.html#dcid) to plot. Example: `country/USA`. <br /> <optional-tag>Optional</optional-tag> if `places` is specified.                                                                     |
 | places         | list   | Places [DCID](/glossary.html#dcid)s to plot, as a space separated list of strings. Example: `"geoId/12 geoId/13"`. <br /> <optional-tag>Optional</optional-tag> if `childPlaceType` and `parentPlace` are specified. |

diff --git a/api/web_components/map.md b/api/web_components/map.md
@@ -39,7 +39,7 @@ permalink: /api/web_components/map
 
 | Name           | Type   | Description                                                                                                                                      |
 | -------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------ |
-| childPlaceType | string | Child place types to plot. Example: `State`. <br /> <optional-tag>Optional</optional-tag> if `places` is specified.                              |
+| childPlaceType | string | Child place types to plot. Example: `State`. For a list of available place types, see the [place types page](/place_types.html).<br /> <optional-tag>Optional</optional-tag> if `places` is specified.                              |
 | header         | string | Chart title.                                                                                                                                     |
 | parentPlace    | string | Parent place [DCID](/glossary.html#dcid) to plot. Example: `country/USA`. <br /> <optional-tag>Optional</optional-tag> if `places` is specified. |
 | variable       | string | Variable [DCID](/glossary.html#dcid) to plot.                                                                                                    |

diff --git a/api/web_components/ranking.md b/api/web_components/ranking.md
@@ -39,7 +39,7 @@ permalink: /api/web_components/ranking
 
 | Name           | Type   | Description                                                                                                                                                                                                       |
 | -------------- | ------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| childPlaceType | string | Child place types to plot. Example: `State`.                                                                                                                                                                      |
+| childPlaceType | string | Child place types to plot. Example: `State`. For a list of available place types, see the [place types page](/place_types.html).                                                                                                                                                                      |
 | header         | string | Chart title.                                                                                                                                                                                                      |
 | parentPlace    | string | Parent place [DCID](/glossary.html#dcid) to plot. Example: `country/USA`.                                                                                                                                         |
 | variable       | string | Variable [DCID](/glossary.html#dcid) to plot.                                                                                                                                                                     |

diff --git a/api/web_components/scatter.md b/api/web_components/scatter.md
@@ -40,7 +40,7 @@ between two variables.
 
 | Name           | Type   | Description                                                                                                                                                                                                         |
 | -------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| childPlaceType | string | Child place types to plot. Example: `State`.                                                                                                                                                                        |
+| childPlaceType | string | Child place types to plot. Example: `State`. For a list of available place types, see the [place types page](/place_types.html).                                                                                                                                                                        |
 | header         | string | Chart title.                                                                                                                                                                                                        |
 | parentPlace    | string | Parent place [DCID](/glossary.html#dcid) to plot. Example: `country/USA`.                                                                                                                                           |
 | variables      | list   | Variable [DCID](/glossary.html#dcid)(s) to plot, as a space separated list of strings. Example: `"Count_Person Count_Farm"`. At least 2 variables must be provided, and only the first 2 variables will be plotted. |

diff --git a/api/web_components/slider.md b/api/web_components/slider.md
@@ -46,7 +46,7 @@ permalink: /api/web_components/slider
 
 | Name           | Type   | Description                                                                                                                                                           |
 | -------------- | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| childPlaceType | string | Child place types of date range. Example: `State`.<br /><br /><optional-tag>optional</optional-tag> if `dates` is specified.                                          |
+| childPlaceType | string | Child place types of date range. Example: `State`. For a list of available place types, see the [place types page](/place_types.html).<br /><br /><optional-tag>optional</optional-tag> if `dates` is specified.                                          |
 | dates          | list   | Set date option range. Example: `"2001 2002 2003"`<br /><br /><optional-tag>optional</optional-tag> if `variable`, `parentPlace`, and `childPlaceType` are specified. |
 | parentPlace    | string | Parent place [DCID](/glossary.html#dcid) of date range. Example: `country/USA`.<br /><br /><optional-tag>optional</optional-tag> if `dates` is specified.             |
 | publish        | string | Event name to publish on slider change.                                                                                                                               |

diff --git a/bigquery/data_in_bq.md b/bigquery/data_in_bq.md
@@ -13,7 +13,7 @@ While Data Commons (DC) has information about a wide variety of types of entitie
 
 The most common type of information about places is in the form of a time series. Each time series is a set of observations, across a set of time periods, about a combination of a place and a variable (also called statistical variable) from a particular source. As an example, [here is the median income in Berkeley, CA over a period of ten years](https://datacommons.org/tools/timeline#place=geoId%2F0606000&statsVar=Median_Income_Person), according to the US Census Bureau.
 
-See the sample queries about [Places](/bigquery/query_places.html) and [Properties of Places](/bigquery/query_property_places.html) to explore further.
+See the sample queries about [Places](/bigquery/query_places.html) and [Properties of Places](/bigquery/query_property_places.html) to explore further. For a list of available place types, take a look at our [place types page](/place_types.html).
 
 
 ## Statistical Variables

diff --git a/glossary.md b/glossary.md
@@ -71,7 +71,7 @@ The time period over which an [observation](#observation) is made. Specified in
 ### Place
 {: #place}
 
-Entities that describe specific geographic locations. Use the search box in [Place Explorer](https://datacommons.org/place) to search for places in the graph, or view the [Graph Browser entry for Place](https://datacommons.org/browser/Place) for a full view of the node.
+Entities that describe specific geographic locations. Use the search box in [Place Explorer](https://datacommons.org/place) to search for places in the graph, or view the [Graph Browser entry for Place](https://datacommons.org/browser/Place) for a full view of the node. To learn more about place types, take a look at the [place types page](/place_types.html).
 
 ### Preferred Facet
 {: #preferred-facet}