Example 2: Geocode and Data Request
Updated
by
PolicyMap
Geocode an address and return data from the Census and CDFI
The query string below is used to geocode an address, return the latitude and longitude, and show total population, population change, median household income, median household income change from the Census and New Markets Tax Credit from the CDFI Fund.
ty=data&t=geo,ind&geoa=1315 Walnut St, Philadelphia, PA 19107&ii=9869069,9948503,9871831,9948620,9894665&bt=4,6
Definition of parameters in string
- ty: The service type, which in this case is 'data': a JSON string.
- t: The data sub type. A single or comma-delimited set of sub types. In this example; geo=geocoding an address and ind=data request.
- geoa: The geocode search string. A free-form string of an address to geocode. As with most geocoders, it can handle many different address formats.
- ii: The indicator id(s). A single or comma-delimited set of numbers. In this example the following IDs are for;
- 9869069 (Population)
- 9948503 (Percent change in population)
- 9871831 (Median household income)
- 9948620 (Percent change in household income)
- 9894665 (New Markets Tax Credit eligibility)
- bt: The boundary type id. A single or comma-delimited set of numbers. In this example; 4=county and 6=tracts.
Results of the query string
{
"responseCode": 200,
"geo": {
"address": {
"zip": "19107",
"address": "Bankers Security Bldg<BR>1315 Walnut St<BR>Philadelphia PA 19107-4719",
"suite": "",
"address2": null,
"city": "Philadelphia",
"address1": "1315 Walnut St",
"plus4": "4719",
"state": "PA"
},
"lng": "-75.162910",
"level": "P4",
"success": true,
"acodes": "V44-I44-P7-100",
"lat": "39.949580",
"which": 3
},
"ind": {
"boundaries": [
{
"boundary": {
"id": 696961140,
"identifier": "42101",
"name": "Philadelphia",
"type": {
"boundaryType": {
"id": 4,
"definitionId": 1252,
"type": "County"
}
},
"indicators": [
{
"indicator": {
"name": "Population",
"datasetId": 108550,
"sources": [
{
"source": {
"dataSource": "Census",
"dataDirectorySection": "Census: Decennial Census and American Community Survey (ACS)",
"dataDescription": "US Bureau of the Census, American Community Survey.",
"display": true
}
}
{
"timeFrame": {
"id": 1612,
"type": "annualrange",
"typeId": 7,
"fullName": "Estimated population, between 2017-2021.",
"fullDescription": "Estimated count of population, between 2017-2021.",
"aggregationRule": 410,
"overlapPercentage": null,
"period": "2017-2021",
"overlayset": "null",
"year": "2017",
"value": "1596865"
}
}
}
}
},
{
"indicator": {
"name": "Pct Chg in Population",
"datasetId": 108550,
"sources": [
{
"source": {
"dataSource": "Census",
"dataDirectorySection": "Census: Decennial Census and American Community Survey (ACS)",
"dataDescription": "US Bureau of the Census, American Community Survey.",
"display": true
}
}
{
"timeFrame": {
"id": 1612,
"type": "annualrange",
"typeId": 7,
"fullName": "Estimated percent change in the number of people between the periods of 2012-2016 and 2017-2021.",
"fullDescription": "Estimated percent change in the count of population between the periods of 2012-2016 and 2017-2021. Percent change calculations are suppressed in cases where the population or household count in either period was less than 10. Percent changes between ACS survey data may reflect changes in geography, particularly with cities, or changes to the questionnaire or coding. Caution should be used when interpreting comparisons. More information is available <a href=\"https:\/\/www.census.gov\/programs-surveys\/acs\/guidance\/comparing-acs-data\/2018\/5-year-comparison.html\" target=\"_blank\">here<\/a>.",
"aggregationRule": 410,
"overlapPercentage": null,
"period": "2017-2021",
"overlayset": "null",
"year": "2017",
"value": "2.37"
}
}
]
}
},
{
"indicator": {
"name": "Median Household Income",
"datasetId": 110700,
"sources": [
{
"source": {
"dataSource": "Census",
"dataDirectorySection": "Census: Decennial Census and American Community Survey (ACS)",
"dataDescription": "US Bureau of the Census, American Community Survey.",
"display": true
}
}
{
"timeFrame": {
"id": 1612,
"type": "annualrange",
"typeId": 7,
"fullName": "Estimated median income of a household, between 2017-2021.",
"fullDescription": "Estimated median income of a household, between 2017-2021.",
"aggregationRule": 410,
"overlapPercentage": null,
"period": "2017-2021",
"overlayset": "null",
"year": "2017",
"value": "52649"
}
}
]
}
},
{
"indicator": {
"name": "Pct Chg in Median Household Income",
"datasetId": 110700,
"sources": [
{
"source": {
"dataSource": "Census",
"dataDirectorySection": "Census: Decennial Census and American Community Survey (ACS)",
"dataDescription": "US Bureau of the Census, American Community Survey.",
"display": true
}
}
{
"timeFrame": {
"id": 1612,
"type": "annualrange",
"typeId": 7,
"fullName": "Estimated percent change in the median income of a household between the periods of 2012-2016 and 2017-2021.",
"fullDescription": "Estimated percent change in the median income of a household between the periods of 2012-2016 and 2017-2021.",
"aggregationRule": 410,
"overlapPercentage": null,
"period": "2017-2021",
"overlayset": "null",
"year": "2017",
"value": "32.38"
}
}
]
}
}
]
}
},
{
"boundary": {
"id": 697100177,
"identifier": "42101000600",
"name": "42101000600",
"type": {
"boundaryType": {
"id": 6,
"definitionId": 1255,
"type": "Census Tract"
}
},
"indicators": [
{
"indicator": {
"name": "Population",
"datasetId": 108550,
"sources": [
{
"source": {
"dataSource": "Census",
"dataDirectorySection": "Census: Decennial Census and American Community Survey (ACS)",
"dataDescription": "US Bureau of the Census, American Community Survey.",
"display": true
}
}
{
"timeFrame": {
"id": 1612,
"type": "annualrange",
"typeId": 7,
"fullName": "Estimated population, between 2017-2021.",
"fullDescription": "Estimated count of population, between 2017-2021.",
"aggregationRule": 410,
"overlapPercentage": null,
"period": "2017-2021",
"overlayset": "null",
"year": "2017",
"value": "1465"
}
}
}
]
}
},
{
"indicator": {
"name": "Pct Chg in Population",
"datasetId": 108550,
"sources": [
{
"source": {
"dataSource": "Census",
"dataDirectorySection": "Census: Decennial Census and American Community Survey (ACS)",
"dataDescription": "US Bureau of the Census, American Community Survey.",
"display": true
}
}
{
"timeFrame": {
"id": 1612,
"type": "annualrange",
"typeId": 7,
"fullName": "Estimated percent change in the number of people between the periods of 2012-2016 and 2017-2021.",
"fullDescription": "Estimated percent change in the count of population between the periods of 2012-2016 and 2017-2021. Percent change calculations are suppressed in cases where the population or household count in either period was less than 10. Percent changes between ACS survey data may reflect changes in geography, particularly with cities, or changes to the questionnaire or coding. Caution should be used when interpreting comparisons. More information is available <a href=\"https:\/\/www.census.gov\/programs-surveys\/acs\/guidance\/comparing-acs-data\/2018\/5-year-comparison.html\" target=\"_blank\">here<\/a>.",
"aggregationRule": 410,
"overlapPercentage": null,
"period": "2017-2021",
"overlayset": "null",
"year": "2017",
"value": "12.61"
}
}
]
}
},
{
"indicator": {
"name": "Median Household Income",
"datasetId": 110700,
"sources": [
{
"source": {
"dataSource": "Census",
"dataDirectorySection": "Census: Decennial Census and American Community Survey (ACS)",
"dataDescription": "US Bureau of the Census, American Community Survey.",
"display": true
}
}
{
"timeFrame": {
"id": 1612,
"type": "annualrange",
"typeId": 7,
"fullName": "Estimated median income of a household, between 2017-2021.",
"fullDescription": "Estimated median income of a household, between 2017-2021.",
"aggregationRule": 410,
"overlapPercentage": null,
"period": "2017-2021",
"overlayset": "null",
"year": "2017",
"value": "90119"
}
}
]
}
},
{
"indicator": {
"name": "Pct Chg in Median Household Income",
"datasetId": 110700,
"sources": [
{
"source": {
"dataSource": "Census",
"dataDirectorySection": "Census: Decennial Census and American Community Survey (ACS)",
"dataDescription": "US Bureau of the Census, American Community Survey.",
"display": true
}
}
{
"timeFrame": {
"id": 1612,
"type": "annualrange",
"typeId": 7,
"fullName": "Estimated percent change in the median income of a household between the periods of 2012-2016 and 2017-2021.",
"fullDescription": "Estimated percent change in the median income of a household between the periods of 2012-2016 and 2017-2021.",
"aggregationRule": 410,
"overlapPercentage": null,
"period": "2017-2021",
"overlayset": "null",
"year": "2017",
"value": "26.48"
}
}
]
}
}
]
}
}
{
"indicator": {
"name": "NMTC Eligibility",
"datasetId": 122050,
"sources": [
{
"source": {
"dataSource": "CDFI Fund and PolicyMap",
"dataDirectorySection": "\/data\/dictionary#CDFI (Community Development Financial Institutions) Fund and PolicyMap",
"dataDescription": "CDFI Fund NMTC Allocation Application and Reinvestment Fund",
"display": true
}
}
{
"timeFrame": {
"id": 315,
"type": "annualrange",
"typeId": 7,
"fullName": "New Markets Tax Credit (NMTC) eligibility status, for CY 2019 using 2011-2015 eligibility data.",
"fullDescription": "The shaded areas on the map are census tracts that the CDFI Fund has determined meet the requirements for the CDFI Fund's New Markets Tax Credit (NMTC) eligibility, for CY 2019 using 2011-2015 Census American Community Survey data. NMTC eligibility is based on a given census tract having either (1) Median Family Income at or below 80% of Area Median Income (AMI) in the period of 2011-2015 or (2) Poverty Rate of 20% or greater in the period of 2011-2015. Additional census tracts may have NMTC Program Eligibility without meeting those criteria but be deemed to be eligible by the CDFI Fund. Census tracts having Insufficient Data appear as gray in the map. These data are mapped to the 2010 Census boundaries. For more information about the NMTC Program, please see our Data Directory.",
"aggregationRule": 110,
"overlapPercentage": null,
"period": "2011-2015",
"overlayset": "null",
"year": "2011",
"value": "Eligible"
}
}
}
]
}
}
}
}
]
},
"debug": {
"executionTime": "0.9709 seconds"
},
"versions": null,
"loginState": 4,
"userId": null
}Some elements of the original return have been removed to simplify the results displayed here.
Description of the results
The geo returns the longitude of -75.162910 and latitude of 39.949580.
The bt object finds
- County=Philadelphia County
- Census Tract=42101000600
The ii objects returns
- 9869069 (Population County) = 1,596,865
- 9869069 (Population Tract) =1465
- 9948503 (Percent change in population for County)=2.37%
- 9948503 (Percent change in population for Tract)=12.61%
- 9871831 (Median household income for County)=$52,649
- 9871831 (Median household income for Tract)=$90,119
- 9948620 (Percent change in household income for County)=32.38%
- 9948620 (Percent change in household income for Tract)=26.48%
- 9894665 (New Markets Tax Credit eligibility for Tract)=Eligible
