From bb78ea7fe5ed71dfc5a64a8cdb1407a54affb2d4 Mon Sep 17 00:00:00 2001 From: andrewxhill Date: Tue, 17 May 2016 15:02:14 -0400 Subject: [PATCH] updated bounary functions --- doc/boundary_functions.md | 21 +++++++++++---------- doc/discovery_functions.md | 2 +- 2 files changed, 12 insertions(+), 11 deletions(-) diff --git a/doc/boundary_functions.md b/doc/boundary_functions.md index 3a289ce..66283db 100644 --- a/doc/boundary_functions.md +++ b/doc/boundary_functions.md @@ -28,10 +28,10 @@ If geometries are not found for the requested `polygon`, `geometry_id`, `timespa #### Example -Insert all Census Tracts from Lower Manhattan and nearby areas within the supplied bounding box to a table named `manhattan_census_tracts` which has columns `the_geom` (geometry) and `geoid` (text). +Insert all Census Tracts from Lower Manhattan and nearby areas within the supplied bounding box to a table named `manhattan_census_tracts` which has columns `the_geom` (geometry) and `geom_refs` (text). ```sql -INSERT INTO manhattan_census_tracts(the_geom, geoid) +INSERT INTO manhattan_census_tracts(the_geom, geom_refs) SELECT * FROM OBS_GetBoundariesByGeometry( ST_MakeEnvelope(-74.0251922607,40.6945658517, @@ -67,14 +67,14 @@ Column Name | Description the_geom | a point geometry on a boundary (e.g., a point that lies on a US Census tract) geom_refs| a string identifier for the geometry (e.g., the geoid of a US Census tract) -If geometries are not found for the requested geometry, `geometry_id`, `timespan`, or `overlap_type`, then null values are returned. +If geometries are not found for the requested geometry, `geometry_id`, `timespan`, or `overlap_type`, then NULL values are returned. #### Example -Insert points that lie on Census Tracts from Lower Manhattan and nearby areas within the supplied bounding box to a table named `manhattan_census_tracts` which has columns `the_geom` (geometry) and `geoid` (text). +Insert points that lie on Census Tracts from Lower Manhattan and nearby areas within the supplied bounding box to a table named `manhattan_tract_points` which has columns `the_geom` (geometry) and `geom_refs` (text). ```sql -INSERT INTO manhattan_census_tract_points(the_geom, geoid) +INSERT INTO manhattan_tract_points (the_geom, geom_refs) SELECT * FROM OBS_GetPointsByGeometry( ST_MakeEnvelope(-74.0251922607,40.6945658517, @@ -175,9 +175,10 @@ geom | a WGS84 polygon geometry #### Example -Use a table of `geometry_id`s (e.g., geoid from the U.S. Census) to select the unique boundaries that they correspond to. +Use a table of `geometry_id`s (e.g., geoid from the U.S. Census) to select the unique boundaries that they correspond to and insert into a table called, `overlapping_polygons`. This is a useful method for creating new choropleths of aggregate data. ```SQL +INSERT INTO overlapping_polygons (the_geom, geometry_id, point_count) SELECT OBS_GetBoundaryById(geometry_id, 'us.census.tiger.county') As the_geom, geometry_id, @@ -213,10 +214,10 @@ If geometries are not found for the requested point and radius, `geometry_id`, ` #### Example -Insert into table `denver_census_tracts` the census tract boundaries and geoids of census tracts which intersect within 10 miles of downtown Denver, Colorado. +Insert into table `denver_census_tracts` the census tract boundaries and geom_refs of census tracts which intersect within 10 miles of downtown Denver, Colorado. ```sql -INSERT INTO denver_census_tracts(the_geom, geoid) +INSERT INTO denver_census_tracts(the_geom, geom_refs) SELECT * FROM OBS_GetBoundariesByPointAndRadius( CDB_LatLng(39.7392, -104.9903), -- Denver, Colorado @@ -255,10 +256,10 @@ If geometries are not found for the requested point and radius, `geometry_id`, ` #### Example -Insert into table `denver_census_tracts` points on US census tracts and their corresponding geoids for census tracts which intersect within 10 miles of downtown Denver, Colorado, USA. +Insert into table `denver_tract_points` points on US census tracts and their corresponding geoids for census tracts which intersect within 10 miles of downtown Denver, Colorado, USA. ```sql -INSERT INTO denver_census_tracts(the_geom, geoid) +INSERT INTO denver_tract_points(the_geom, geom_refs) SELECT * FROM OBS_GetPointsByPointAndRadius( CDB_LatLng(39.7392, -104.9903), -- Denver, Colorado diff --git a/doc/discovery_functions.md b/doc/discovery_functions.md index 406886e..9b23589 100644 --- a/doc/discovery_functions.md +++ b/doc/discovery_functions.md @@ -49,7 +49,7 @@ Key | Description --- | --- boundary_id | a boundary identifier from the [boundary ID glossary](/cartodb-platform/data/glossary/#boundary-ids) description | a brief description of the boundary dataset -timespan | the timespan attached the boundary. this does not mean that the boundary is invalid outside of the timespan, but is the explicit timespan published with the geometry. +time_span | the timespan attached the boundary. this does not mean that the boundary is invalid outside of the timespan, but is the explicit timespan published with the geometry. #### Example