From f92191a69f38dbc520c0699567f02d120864780a Mon Sep 17 00:00:00 2001 From: csobier Date: Fri, 18 Mar 2016 14:11:59 -0400 Subject: [PATCH 1/2] added note about zcta under postal codes generator section --- doc/API.md | 7 ++++--- doc/general_concepts.md | 2 +- doc/geocoding_functions.md | 6 +++--- doc/isoline_functions.md | 2 +- doc/quota_information.md | 2 +- 5 files changed, 10 insertions(+), 9 deletions(-) diff --git a/doc/API.md b/doc/API.md index da60037..a895121 100644 --- a/doc/API.md +++ b/doc/API.md @@ -9,6 +9,7 @@ The isoline functions provide a way to generate isolines in terms of distance an ## Documentation * [Quickstart](quickstart.md) -* [General concepts](general_concepts.md) -* [Geocoding functions](geocoding_functions.md) -* [Isoline functions](isoline_functions.md) +* [General Concepts](general_concepts.md) +* [Geocoding Functions](geocoding_functions.md) +* [Isoline Functions](isoline_functions.md) +* [Quota Information](quota_information.md) diff --git a/doc/general_concepts.md b/doc/general_concepts.md index 10f0a13..3b4baa1 100644 --- a/doc/general_concepts.md +++ b/doc/general_concepts.md @@ -1,4 +1,4 @@ -# General concepts +# General Concepts The Data Services API offers geocoding and isoline services on top of the CartoDB SQL API by means of a set of functions. Each one of these functions is oriented to one kind of operation and returns the corresponding geometry (a `polygon` or a `point`), according to the input information. diff --git a/doc/geocoding_functions.md b/doc/geocoding_functions.md index 6defcaa..228f056 100644 --- a/doc/geocoding_functions.md +++ b/doc/geocoding_functions.md @@ -1,4 +1,4 @@ -# Geocoding functions +# Geocoding Functions The following geocoding functions are available, grouped by categories. @@ -181,6 +181,8 @@ UPDATE {tablename} SET the_geom = cdb_geocode_namedplace_point({city_column}, {p The following functions provide a postal code geocoding service that can be used to obtain points or polygon results. The postal code polygon geocoder covers the United States, France, Australia and Canada; a request for a different country will return an empty response. +**Note:** For the USA, US Census [Zip Code Tabulation Areas](https://www.census.gov/geo/reference/zctas.html) (ZCTA) are used to reference geocodes for USPS postal codes service areas. + ### cdb_geocode_postalcode_polygon(_postal_code text, country_name text_) #### Arguments @@ -208,8 +210,6 @@ SELECT cdb_geocode_postalcode_polygon('11211', 'USA') UPDATE {tablename} SET the_geom = cdb_geocode_postalcode_polygon({postal_code_column}, 'USA') ``` -**Note:** For the USA, US Census ZCTAs are considered. - ### cdb_geocode_postalcode_point(_code text, country_name text_) #### Arguments diff --git a/doc/isoline_functions.md b/doc/isoline_functions.md index 630f205..395defd 100644 --- a/doc/isoline_functions.md +++ b/doc/isoline_functions.md @@ -1,4 +1,4 @@ -# Isoline functions +# Isoline Functions The following functions provide an isolines generator service based on time or distance. This service uses the isolines service defined for the user (currently, only the Here isolines service is available). diff --git a/doc/quota_information.md b/doc/quota_information.md index d3cfaba..900d4f0 100644 --- a/doc/quota_information.md +++ b/doc/quota_information.md @@ -1,4 +1,4 @@ -# Quota information +# Quota Information **This Data Services API provides functions which are subject to quota limitations, and extra fees may apply**. Please check our [terms and conditions](https://cartodb.com/terms/). From 0ca1b840962ca364533b62f0cfd9778bcf7fbdbf Mon Sep 17 00:00:00 2001 From: csobier Date: Mon, 21 Mar 2016 16:42:48 -0400 Subject: [PATCH 2/2] added link to docs faq regarding zcta --- doc/geocoding_functions.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/geocoding_functions.md b/doc/geocoding_functions.md index 228f056..46f6e4c 100644 --- a/doc/geocoding_functions.md +++ b/doc/geocoding_functions.md @@ -181,7 +181,7 @@ UPDATE {tablename} SET the_geom = cdb_geocode_namedplace_point({city_column}, {p The following functions provide a postal code geocoding service that can be used to obtain points or polygon results. The postal code polygon geocoder covers the United States, France, Australia and Canada; a request for a different country will return an empty response. -**Note:** For the USA, US Census [Zip Code Tabulation Areas](https://www.census.gov/geo/reference/zctas.html) (ZCTA) are used to reference geocodes for USPS postal codes service areas. +**Note:** For the USA, US Census [Zip Code Tabulation Areas](https://www.census.gov/geo/reference/zctas.html) (ZCTA) are used to reference geocodes for USPS postal codes service areas. See the [FAQs](http://docs.cartodb.com/faqs/datasets-and-data/#why-does-cartodb-use-census-bureau-zctas-and-not-usps-zip-codes-for-postal-codes) about datasets and data for details. ### cdb_geocode_postalcode_polygon(_postal_code text, country_name text_)