added
8.21.23 - GeoSearch and GeoChildren queries added to Taxonomy GraphQL API
8 months ago by Hannah Oren
Two new queries are now available in the Taxonomy API: GeoSearch and GeoChildren. These queries return codes from the GeoNames taxonomy that can be used to identify geographic information.
GeoName IDs can be used as search parameters to filter the Grants and News APIs by geographic areas.
See below for examples of these queries and results. More information can be found in the Taxonomy API docs and user guides.
GeoSearch
The GeoSearch query uses a keyword input to return relevant results from the GeoNames taxonomy, and can be filtered by geographic level.
{
geoSearch (searchTerms: "ohio", geoLevel:ADM1) {
data {
id
name
displayName
geoLevel
countryCode
}
}
}
{
"data": {
"geoSearch": {
"data": [
{
"id": 5165418,
"name": "Ohio",
"displayName": "Ohio (United States)",
"geoLevel": "ADM1",
"countryCode": "US"
}
]
}
}
}
GeoChildren
The GeoChildren query returns the child terms for a given GeoNames code.
{
geoChildren (parentId: 5165418, parentLevel: ADM1, childLevel: ADM2) {
data {
id
geoLevel
name
displayName
}
}
}
{
"data": {
"geoChildren": {
"data": [
{
"id": 4505006,
"geoLevel": "ADM2",
"name": "Adams County",
"displayName": "Adams County (Ohio, United States)"
},
{
"id": 5145576,
"geoLevel": "ADM2",
"name": "Allen County",
"displayName": "Allen County (Ohio, United States)"
},
{
"id": 5146062,
"geoLevel": "ADM2",
"name": "Ashland County",
"displayName": "Ashland County (Ohio, United States)"
},
{
"id": 5146092,
"geoLevel": "ADM2",
"name": "Ashtabula County",
"displayName": "Ashtabula County (Ohio, United States)"
},
{
"id": 4505546,
"geoLevel": "ADM2",
"name": "Athens County",
"displayName": "Athens County (Ohio, United States)"
},
{
"id": 5146199,
"geoLevel": "ADM2",
"name": "Auglaize County",
"displayName": "Auglaize County (Ohio, United States)"
},
{
"id": 5147012,
"geoLevel": "ADM2",
"name": "Belmont County",
"displayName": "Belmont County (Ohio, United States)"
},
{
"id": 4507215,
"geoLevel": "ADM2",
"name": "Brown County",
"displayName": "Brown County (Ohio, United States)"
},
{
"id": 4507568,
"geoLevel": "ADM2",
"name": "Butler County",
"displayName": "Butler County (Ohio, United States)"
},
{
"id": 5149311,
"geoLevel": "ADM2",
"name": "Carroll County",
"displayName": "Carroll County (Ohio, United States)"
},
{
"id": 5149757,
"geoLevel": "ADM2",
"name": "Champaign County",
"displayName": "Champaign County (Ohio, United States)"
},
{
"id": 4508810,
"geoLevel": "ADM2",
"name": "Clark County",
"displayName": "Clark County (Ohio, United States)"
},
{
"id": 4508924,
"geoLevel": "ADM2",
"name": "Clermont County",
"displayName": "Clermont County (Ohio, United States)"
},
{
"id": 4508988,
"geoLevel": "ADM2",
"name": "Clinton County",
"displayName": "Clinton County (Ohio, United States)"
},
{
"id": 5150853,
"geoLevel": "ADM2",
"name": "Columbiana County",
"displayName": "Columbiana County (Ohio, United States)"
},
{
"id": 5151190,
"geoLevel": "ADM2",
"name": "Coshocton County",
"displayName": "Coshocton County (Ohio, United States)"
},
{
"id": 5151374,
"geoLevel": "ADM2",
"name": "Crawford County",
"displayName": "Crawford County (Ohio, United States)"
},
{
"id": 5151606,
"geoLevel": "ADM2",
"name": "Cuyahoga County",
"displayName": "Cuyahoga County (Ohio, United States)"
},
{
"id": 5151705,
"geoLevel": "ADM2",
"name": "Darke County",
"displayName": "Darke County (Ohio, United States)"
},
{
"id": 5151865,
"geoLevel": "ADM2",
"name": "Defiance County",
"displayName": "Defiance County (Ohio, United States)"
},
{
"id": 5151896,
"geoLevel": "ADM2",
"name": "Delaware County",
"displayName": "Delaware County (Ohio, United States)"
},
{
"id": 5153362,
"geoLevel": "ADM2",
"name": "Erie County",
"displayName": "Erie County (Ohio, United States)"
},
{
"id": 4511295,
"geoLevel": "ADM2",
"name": "Fairfield County",
"displayName": "Fairfield County (Ohio, United States)"
},
{
"id": 4511521,
"geoLevel": "ADM2",
"name": "Fayette County",
"displayName": "Fayette County (Ohio, United States)"
},
{
"id": 4512214,
"geoLevel": "ADM2",
"name": "Franklin County",
"displayName": "Franklin County (Ohio, United States)"
},
{
"id": 5155347,
"geoLevel": "ADM2",
"name": "Fulton County",
"displayName": "Fulton County (Ohio, United States)"
},
{
"id": 4512438,
"geoLevel": "ADM2",
"name": "Gallia County",
"displayName": "Gallia County (Ohio, United States)"
},
{
"id": 5155556,
"geoLevel": "ADM2",
"name": "Geauga County",
"displayName": "Geauga County (Ohio, United States)"
},
{
"id": 4513280,
"geoLevel": "ADM2",
"name": "Greene County",
"displayName": "Greene County (Ohio, United States)"
},
{
"id": 5156615,
"geoLevel": "ADM2",
"name": "Guernsey County",
"displayName": "Guernsey County (Ohio, United States)"
},
{
"id": 4513583,
"geoLevel": "ADM2",
"name": "Hamilton County",
"displayName": "Hamilton County (Ohio, United States)"
},
{
"id": 5156770,
"geoLevel": "ADM2",
"name": "Hancock County",
"displayName": "Hancock County (Ohio, United States)"
},
{
"id": 5156844,
"geoLevel": "ADM2",
"name": "Hardin County",
"displayName": "Hardin County (Ohio, United States)"
},
{
"id": 5156975,
"geoLevel": "ADM2",
"name": "Harrison County",
"displayName": "Harrison County (Ohio, United States)"
},
{
"id": 5157338,
"geoLevel": "ADM2",
"name": "Henry County",
"displayName": "Henry County (Ohio, United States)"
},
{
"id": 4514204,
"geoLevel": "ADM2",
"name": "Highland County",
"displayName": "Highland County (Ohio, United States)"
},
{
"id": 4514358,
"geoLevel": "ADM2",
"name": "Hocking County",
"displayName": "Hocking County (Ohio, United States)"
},
{
"id": 5157783,
"geoLevel": "ADM2",
"name": "Holmes County",
"displayName": "Holmes County (Ohio, United States)"
},
{
"id": 5158275,
"geoLevel": "ADM2",
"name": "Huron County",
"displayName": "Huron County (Ohio, United States)"
},
{
"id": 4515328,
"geoLevel": "ADM2",
"name": "Jackson County",
"displayName": "Jackson County (Ohio, United States)"
},
{
"id": 5159079,
"geoLevel": "ADM2",
"name": "Jefferson County",
"displayName": "Jefferson County (Ohio, United States)"
},
{
"id": 5159891,
"geoLevel": "ADM2",
"name": "Knox County",
"displayName": "Knox County (Ohio, United States)"
},
{
"id": 5160090,
"geoLevel": "ADM2",
"name": "Lake County",
"displayName": "Lake County (Ohio, United States)"
},
{
"id": 4516351,
"geoLevel": "ADM2",
"name": "Lawrence County",
"displayName": "Lawrence County (Ohio, United States)"
},
{
"id": 5160740,
"geoLevel": "ADM2",
"name": "Licking County",
"displayName": "Licking County (Ohio, United States)"
},
{
"id": 5161156,
"geoLevel": "ADM2",
"name": "Logan County",
"displayName": "Logan County (Ohio, United States)"
},
{
"id": 5161272,
"geoLevel": "ADM2",
"name": "Lorain County",
"displayName": "Lorain County (Ohio, United States)"
},
{
"id": 5161413,
"geoLevel": "ADM2",
"name": "Lucas County",
"displayName": "Lucas County (Ohio, United States)"
},
{
"id": 4517365,
"geoLevel": "ADM2",
"name": "Madison County",
"displayName": "Madison County (Ohio, United States)"
},
{
"id": 5161640,
"geoLevel": "ADM2",
"name": "Mahoning County",
"displayName": "Mahoning County (Ohio, United States)"
},
{
"id": 5161911,
"geoLevel": "ADM2",
"name": "Marion County",
"displayName": "Marion County (Ohio, United States)"
},
{
"id": 5162517,
"geoLevel": "ADM2",
"name": "Medina County",
"displayName": "Medina County (Ohio, United States)"
},
{
"id": 4518038,
"geoLevel": "ADM2",
"name": "Meigs County",
"displayName": "Meigs County (Ohio, United States)"
},
{
"id": 5162679,
"geoLevel": "ADM2",
"name": "Mercer County",
"displayName": "Mercer County (Ohio, United States)"
},
{
"id": 5162774,
"geoLevel": "ADM2",
"name": "Miami County",
"displayName": "Miami County (Ohio, United States)"
},
{
"id": 4518563,
"geoLevel": "ADM2",
"name": "Monroe County",
"displayName": "Monroe County (Ohio, United States)"
},
{
"id": 4518598,
"geoLevel": "ADM2",
"name": "Montgomery County",
"displayName": "Montgomery County (Ohio, United States)"
},
{
"id": 4518677,
"geoLevel": "ADM2",
"name": "Morgan County",
"displayName": "Morgan County (Ohio, United States)"
},
{
"id": 5163509,
"geoLevel": "ADM2",
"name": "Morrow County",
"displayName": "Morrow County (Ohio, United States)"
},
{
"id": 4519300,
"geoLevel": "ADM2",
"name": "Muskingum County",
"displayName": "Muskingum County (Ohio, United States)"
},
{
"id": 4519808,
"geoLevel": "ADM2",
"name": "Noble County",
"displayName": "Noble County (Ohio, United States)"
},
{
"id": 5165803,
"geoLevel": "ADM2",
"name": "Ottawa County",
"displayName": "Ottawa County (Ohio, United States)"
},
{
"id": 5166256,
"geoLevel": "ADM2",
"name": "Paulding County",
"displayName": "Paulding County (Ohio, United States)"
},
{
"id": 4521093,
"geoLevel": "ADM2",
"name": "Perry County",
"displayName": "Perry County (Ohio, United States)"
},
{
"id": 4521196,
"geoLevel": "ADM2",
"name": "Pickaway County",
"displayName": "Pickaway County (Ohio, United States)"
},
{
"id": 4521245,
"geoLevel": "ADM2",
"name": "Pike County",
"displayName": "Pike County (Ohio, United States)"
},
{
"id": 5167284,
"geoLevel": "ADM2",
"name": "Portage County",
"displayName": "Portage County (Ohio, United States)"
},
{
"id": 4521907,
"geoLevel": "ADM2",
"name": "Preble County",
"displayName": "Preble County (Ohio, United States)"
},
{
"id": 5167574,
"geoLevel": "ADM2",
"name": "Putnam County",
"displayName": "Putnam County (Ohio, United States)"
},
{
"id": 5168041,
"geoLevel": "ADM2",
"name": "Richland County",
"displayName": "Richland County (Ohio, United States)"
},
{
"id": 4522889,
"geoLevel": "ADM2",
"name": "Ross County",
"displayName": "Ross County (Ohio, United States)"
},
{
"id": 5170698,
"geoLevel": "ADM2",
"name": "Sandusky County",
"displayName": "Sandusky County (Ohio, United States)"
},
{
"id": 4524221,
"geoLevel": "ADM2",
"name": "Scioto County",
"displayName": "Scioto County (Ohio, United States)"
},
{
"id": 5171643,
"geoLevel": "ADM2",
"name": "Seneca County",
"displayName": "Seneca County (Ohio, United States)"
},
{
"id": 5171871,
"geoLevel": "ADM2",
"name": "Shelby County",
"displayName": "Shelby County (Ohio, United States)"
},
{
"id": 5172936,
"geoLevel": "ADM2",
"name": "Stark County",
"displayName": "Stark County (Ohio, United States)"
},
{
"id": 5173386,
"geoLevel": "ADM2",
"name": "Summit County",
"displayName": "Summit County (Ohio, United States)"
},
{
"id": 5174418,
"geoLevel": "ADM2",
"name": "Trumbull County",
"displayName": "Trumbull County (Ohio, United States)"
},
{
"id": 5174499,
"geoLevel": "ADM2",
"name": "Tuscarawas County",
"displayName": "Tuscarawas County (Ohio, United States)"
},
{
"id": 5174669,
"geoLevel": "ADM2",
"name": "Union County",
"displayName": "Union County (Ohio, United States)"
},
{
"id": 5175012,
"geoLevel": "ADM2",
"name": "Van Wert County",
"displayName": "Van Wert County (Ohio, United States)"
},
{
"id": 4527250,
"geoLevel": "ADM2",
"name": "Vinton County",
"displayName": "Vinton County (Ohio, United States)"
},
{
"id": 4527624,
"geoLevel": "ADM2",
"name": "Warren County",
"displayName": "Warren County (Ohio, United States)"
},
{
"id": 4527654,
"geoLevel": "ADM2",
"name": "Washington County",
"displayName": "Washington County (Ohio, United States)"
},
{
"id": 5175898,
"geoLevel": "ADM2",
"name": "Wayne County",
"displayName": "Wayne County (Ohio, United States)"
},
{
"id": 5176872,
"geoLevel": "ADM2",
"name": "Williams County",
"displayName": "Williams County (Ohio, United States)"
},
{
"id": 5177229,
"geoLevel": "ADM2",
"name": "Wood County",
"displayName": "Wood County (Ohio, United States)"
},
{
"id": 5177434,
"geoLevel": "ADM2",
"name": "Wyandot County",
"displayName": "Wyandot County (Ohio, United States)"
}
]
}
}
}
Want to try it out?
Request access today.