R/resolve.R
dc_get_dcid_by_coordinates.RdResolves geographic coordinates (provided as latitude and longitude) to Data Commons DCIDs using the geoCoordinate property.
dc_get_dcid_by_coordinates(
latitude,
longitude,
api_key = Sys.getenv("DATACOMMONS_API_KEY"),
base_url = Sys.getenv("DATACOMMONS_BASE_URL", unset =
"https://api.datacommons.org/v2/"),
return_type = "json"
)A numeric vector of latitude values.
A numeric vector of longitude values.
Your Data Commons API key. If not provided, uses the
environment variable DATACOMMONS_API_KEY.
The base URL of the Data Commons API. Defaults to the public
endpoint. For custom deployments, must end with /core/api/v2/.
Return format: either "list" (parsed R object) or
"json" (JSON string).
A list or JSON string, depending on return_type.
# Get the DCID for a coordinate
dc_get_dcid_by_coordinates(37.42, -122.08)
#> [1] "{\"entities\":[{\"node\":\"37.42#-122.08\",\"candidates\":[{\"dcid\":\"geoId/0649670\",\"dominantType\":\"City\"},{\"dcid\":\"geoId/06085\",\"dominantType\":\"County\"},{\"dcid\":\"geoId/06\",\"dominantType\":\"State\"},{\"dcid\":\"country/USA\",\"dominantType\":\"Country\"},{\"dcid\":\"geoId/06085504601\",\"dominantType\":\"CensusTract\"},{\"dcid\":\"geoId/060855046011\",\"dominantType\":\"CensusBlockGroup\"},{\"dcid\":\"geoId/0608592830\",\"dominantType\":\"CensusCountyDivision\"},{\"dcid\":\"geoId/0618\",\"dominantType\":\"CongressionalDistrict\"},{\"dcid\":\"geoId/sch0626280\",\"dominantType\":\"SchoolDistrict\"},{\"dcid\":\"ipcc_50/37.25_-122.25_USA\",\"dominantType\":\"IPCCPlace_50\"},{\"dcid\":\"zip/94043\",\"dominantType\":\"CensusZipCodeTabulationArea\"}]}]}"
# Batch query for multiple coordinates
dc_get_dcid_by_coordinates(c(34.05, 40.71), c(-118.25, -74.01))
#> iterating ■■■ 5% | ETA: 37s
#> [1] "{\"entities\":[{\"node\":\"34.05#-118.25\",\"candidates\":[{\"dcid\":\"geoId/0644000\",\"dominantType\":\"City\"},{\"dcid\":\"geoId/06037\",\"dominantType\":\"County\"},{\"dcid\":\"geoId/06\",\"dominantType\":\"State\"},{\"dcid\":\"country/USA\",\"dominantType\":\"Country\"},{\"dcid\":\"geoId/06037207301\",\"dominantType\":\"CensusTract\"},{\"dcid\":\"geoId/060372073012\",\"dominantType\":\"CensusBlockGroup\"},{\"dcid\":\"geoId/0603791750\",\"dominantType\":\"CensusCountyDivision\"},{\"dcid\":\"geoId/0634\",\"dominantType\":\"CongressionalDistrict\"},{\"dcid\":\"geoId/sch0622710\",\"dominantType\":\"SchoolDistrict\"},{\"dcid\":\"ipcc_50/34.25_-118.25_USA\",\"dominantType\":\"IPCCPlace_50\"},{\"dcid\":\"zip/90013\",\"dominantType\":\"CensusZipCodeTabulationArea\"}]},{\"node\":\"40.71#-74.01\",\"candidates\":[{\"dcid\":\"geoId/3651000\",\"dominantType\":\"City\"},{\"dcid\":\"geoId/36061\",\"dominantType\":\"County\"},{\"dcid\":\"geoId/36\",\"dominantType\":\"State\"},{\"dcid\":\"country/USA\",\"dominantType\":\"Country\"},{\"dcid\":\"geoId/36061001300\",\"dominantType\":\"CensusTract\"},{\"dcid\":\"geoId/360610013001\",\"dominantType\":\"CensusBlockGroup\"},{\"dcid\":\"geoId/3606144919\",\"dominantType\":\"CensusCountyDivision\"},{\"dcid\":\"geoId/3610\",\"dominantType\":\"CongressionalDistrict\"},{\"dcid\":\"geoId/sch3620580\",\"dominantType\":\"SchoolDistrict\"},{\"dcid\":\"ipcc_50/40.75_-74.25_USA\",\"dominantType\":\"IPCCPlace_50\"},{\"dcid\":\"zip/10006\",\"dominantType\":\"CensusZipCodeTabulationArea\"}]}]}"