resolve_via_socrata: Resolve a Download URL via the Socrata Metadata API

In rmoriebricklayer: Reproducible Data Capsules with Provenance and Fallback

Resolve a Download URL via the Socrata Metadata API

Description

Verifies that a Socrata dataset still exists by fetching its api/views metadata, then returns the canonical CSV export URL. Socrata powers the Calgary, Chicago, and NYC open-data portals used across the MORIE family.

Usage

resolve_via_socrata(provenance)

Arguments

provenance

A provenance list as returned by load_provenance(). Must contain dataset$socrata_domain (e.g. "data.cityofchicago.org") and dataset$socrata_id (the 4x4 dataset id, e.g. "ijzp-q8t2").

Value

The CSV export URL as a character string, or NULL if the fields are missing, the request fails, or the metadata reports an error.

Examples

# Missing fields return NULL rather than erroring:
resolve_via_socrata(list())

prov <- list(dataset = list(socrata_domain = "data.cityofchicago.org",
                            socrata_id     = "ijzp-q8t2"))
resolve_via_socrata(prov)

rmoriebricklayer documentation built on Aug. 5, 2026, 9:08 a.m.