{"contractVersion":"parcelops.connector.v1","name":"carb-air","displayName":"CA Air Resources Board","description":"California air-quality regulatory geography and CARB-issued carbon offset projects. A point lookup returns the air district and air basin that govern a location, plus any AB 617 community air protection area it falls inside. AB 617 selection is an environmental justice signal for air quality. Offset search covers the CARB ARBOC issuance map: forest project polygons with acreage, operator, and net credits issued, alongside livestock, mine methane capture, and ozone-depleting-substance projects across 19 states. Districts, basins, and AB 617 areas are California only; offset projects are national. Emissions inventory records and cap-and-trade permit, auction, and compliance data publish as rotating bulk files and spreadsheets and are not exposed here.","tags":["carb","california","air-quality","air-district","air-basin","ab617","community-air-protection","environmental-justice","carbon-offsets","forest-carbon","siting","entitlement-risk","land","environmental"],"authentication":{"type":"none","required":false},"provenance":{"sourceName":"California Air Resources Board GIS — Air Districts, Air Basins, AB 617 Communities, ARBOC Offset Issuance","sourceUrl":"https://gis.carb.arb.ca.gov/hosting/rest/services","apiBaseUrl":"https://gis.carb.arb.ca.gov/hosting/rest/services","documentationUrl":"https://ww2.arb.ca.gov/our-work/programs/compliance-offset-program"},"freshness":{"status":"declared","value":{"mode":"scheduled","notes":"CARB republishes these map services irregularly and announces no cadence. Offset issuance changes as projects are verified; district, basin, and AB 617 boundaries change rarely."}},"coverage":{"geographic":{"status":"declared","value":["California — air districts (35 polygons), air basins, and AB 617 community air protection areas (19 selected communities), statewide","United States — CARB offset projects. The point layers publish a state for AZ, CA, FL, ID, IN, MI, MN, MO, NC, NY, OH, OR, PA, SD, UT, VA, VT, WA, and WI (19 states); the forest polygons span the continental United States and Alaska and publish no state field at all"]},"temporal":{"status":"declared","value":{"notes":"Offset issuance records reach back to early-action projects and are updated as verifications complete. CARB publishes no vintage stamp on these services."}}},"methods":{"total":4,"items":[{"name":"getAirDistrictContext","description":"Which CARB air district, air basin, and AB 617 community area govern one set of coordinates.","notes":"California only. Outside the state every polygon is null.","requiredParams":["latitude","longitude"],"inputSchema":{"type":"object","properties":{"latitude":{"type":"number","minimum":-90,"maximum":90},"longitude":{"type":"number","minimum":-180,"maximum":180}},"required":["latitude","longitude"],"additionalProperties":false},"access":{"classification":"read"},"freshness":{"status":"declared","value":{"mode":"scheduled","notes":"CARB republishes these map services irregularly and announces no cadence. Offset issuance changes as projects are verified; district, basin, and AB 617 boundaries change rarely."},"scope":"connector"},"entities":{"status":"not_declared"},"pagination":{"status":"not_declared"},"output":{"schema":{"status":"not_declared"},"units":{"status":"not_declared"},"coordinateReferenceSystem":{"status":"not_declared"}},"caveats":["Air-district and air-basin polygons name the agency with permitting jurisdiction over a location. They are not a permit, an entitlement, an approval, or a compliance determination.","AB 617 selection records where CARB directed community air monitoring, an emissions reduction program, or both. It is a program status, not a measured air-quality reading, and a null result means the point is outside all 19 selected communities rather than that air quality was assessed.","CARB offset projects are national, not California only. The forest layer publishes no state field, so a state filter cannot reach forest polygons; use coordinates instead.","Net credits issued is a NET figure and can be negative, which signals reversed or invalidated credits. Overlapping project ids frequently cover identical acreage, so credits and acreage must never be summed across records without deduplicating on geometry first.","Acreage is the CARB web-map GIS figure for the mapped polygon — cartographic, not surveyed or deeded. A forest offset project also carries a long-running management covenant whose terms live in the project documentation, not in this data.","Emissions inventory records (facility tonnages, criteria pollutants, toxics, health-risk screening scores) and cap-and-trade permit, auction, and compliance data are NOT exposed by this connector. They publish as rotating bulk files, undocumented JSONP, XLSX, and PDF, and are deferred to a later phase.","CARB publishes no API contract, versioning, or deprecation policy for these services, and arb.ca.gov sits behind a web application firewall that answers a rejected request with HTTP 200 and an HTML page. This connector detects that body and raises an error rather than reporting an empty result.","Reuse rests on the State of California statewide public-domain default; CARB publishes no dataset-level licence grant, so carry the attribution \"California Air Resources Board (CARB)\"."]},{"name":"searchAb617Communities","description":"Search AB 617 community air protection areas at a point, near a point, or across the state list.","notes":"latitude and longitude go together; radiusMiles needs both.","inputSchema":{"type":"object","properties":{"latitude":{"type":"number","minimum":-90,"maximum":90},"longitude":{"type":"number","minimum":-180,"maximum":180},"radiusMiles":{"type":"number","minimum":0.1,"maximum":100},"communityName":{"type":"string","minLength":2,"maxLength":200},"districtAcronym":{"type":"string","minLength":2,"maxLength":40},"yearSelected":{"type":"integer","minimum":2017,"maximum":2030},"limit":{"type":"integer","minimum":1,"maximum":50}},"required":[],"additionalProperties":false},"access":{"classification":"read"},"freshness":{"status":"declared","value":{"mode":"scheduled","notes":"CARB republishes these map services irregularly and announces no cadence. Offset issuance changes as projects are verified; district, basin, and AB 617 boundaries change rarely."},"scope":"connector"},"entities":{"status":"not_declared"},"pagination":{"status":"not_declared"},"output":{"schema":{"status":"not_declared"},"units":{"status":"not_declared"},"coordinateReferenceSystem":{"status":"not_declared"}},"caveats":["Air-district and air-basin polygons name the agency with permitting jurisdiction over a location. They are not a permit, an entitlement, an approval, or a compliance determination.","AB 617 selection records where CARB directed community air monitoring, an emissions reduction program, or both. It is a program status, not a measured air-quality reading, and a null result means the point is outside all 19 selected communities rather than that air quality was assessed.","CARB offset projects are national, not California only. The forest layer publishes no state field, so a state filter cannot reach forest polygons; use coordinates instead.","Net credits issued is a NET figure and can be negative, which signals reversed or invalidated credits. Overlapping project ids frequently cover identical acreage, so credits and acreage must never be summed across records without deduplicating on geometry first.","Acreage is the CARB web-map GIS figure for the mapped polygon — cartographic, not surveyed or deeded. A forest offset project also carries a long-running management covenant whose terms live in the project documentation, not in this data.","Emissions inventory records (facility tonnages, criteria pollutants, toxics, health-risk screening scores) and cap-and-trade permit, auction, and compliance data are NOT exposed by this connector. They publish as rotating bulk files, undocumented JSONP, XLSX, and PDF, and are deferred to a later phase.","CARB publishes no API contract, versioning, or deprecation policy for these services, and arb.ca.gov sits behind a web application firewall that answers a rejected request with HTTP 200 and an HTML page. This connector detects that body and raises an error rather than reporting an empty result.","Reuse rests on the State of California statewide public-domain default; CARB publishes no dataset-level licence grant, so carry the attribution \"California Air Resources Board (CARB)\"."]},{"name":"searchOffsetProjects","description":"Find CARB offset projects covering a point, near a point, or by id, name, operator, state, or size.","notes":"Coordinates without radiusMiles test polygon containment only.","inputSchema":{"type":"object","properties":{"projectType":{"type":"string","enum":["forest","livestock","mineMethane","ozoneDepleting"]},"arbProjectId":{"type":"string","pattern":"^CA[A-Za-z]{2}\\d{4}$","description":"CARB project id such as CAFR0001."},"projectName":{"type":"string","minLength":3,"maxLength":200},"operator":{"type":"string","minLength":3,"maxLength":200},"stateAlpha":{"type":"string","pattern":"^[A-Za-z]{2}$","description":"Point-layer projects only; forest polygons publish no state."},"minNetCredits":{"type":"integer"},"minAcres":{"type":"integer","minimum":0,"description":"Forest projects only."},"latitude":{"type":"number","minimum":-90,"maximum":90},"longitude":{"type":"number","minimum":-180,"maximum":180},"radiusMiles":{"type":"number","minimum":0.1,"maximum":250},"limit":{"type":"integer","minimum":1,"maximum":200}},"required":[],"additionalProperties":false},"access":{"classification":"read"},"freshness":{"status":"declared","value":{"mode":"scheduled","notes":"CARB republishes these map services irregularly and announces no cadence. Offset issuance changes as projects are verified; district, basin, and AB 617 boundaries change rarely."},"scope":"connector"},"entities":{"status":"not_declared"},"pagination":{"status":"not_declared"},"output":{"schema":{"status":"not_declared"},"units":{"status":"not_declared"},"coordinateReferenceSystem":{"status":"not_declared"}},"caveats":["Air-district and air-basin polygons name the agency with permitting jurisdiction over a location. They are not a permit, an entitlement, an approval, or a compliance determination.","AB 617 selection records where CARB directed community air monitoring, an emissions reduction program, or both. It is a program status, not a measured air-quality reading, and a null result means the point is outside all 19 selected communities rather than that air quality was assessed.","CARB offset projects are national, not California only. The forest layer publishes no state field, so a state filter cannot reach forest polygons; use coordinates instead.","Net credits issued is a NET figure and can be negative, which signals reversed or invalidated credits. Overlapping project ids frequently cover identical acreage, so credits and acreage must never be summed across records without deduplicating on geometry first.","Acreage is the CARB web-map GIS figure for the mapped polygon — cartographic, not surveyed or deeded. A forest offset project also carries a long-running management covenant whose terms live in the project documentation, not in this data.","Emissions inventory records (facility tonnages, criteria pollutants, toxics, health-risk screening scores) and cap-and-trade permit, auction, and compliance data are NOT exposed by this connector. They publish as rotating bulk files, undocumented JSONP, XLSX, and PDF, and are deferred to a later phase.","CARB publishes no API contract, versioning, or deprecation policy for these services, and arb.ca.gov sits behind a web application firewall that answers a rejected request with HTTP 200 and an HTML page. This connector detects that body and raises an error rather than reporting an empty result.","Reuse rests on the State of California statewide public-domain default; CARB publishes no dataset-level licence grant, so carry the attribution \"California Air Resources Board (CARB)\"."]},{"name":"getServiceInfo","description":"Return CARB layer schemas, record counts, license terms, and what this connector does not expose.","inputSchema":{"type":"object","properties":{"service":{"type":"string","enum":["airDistricts","airBasins","ab617Communities","ab617Districts","offsetForest","offsetLivestock","offsetMineMethane","offsetOzoneDepleting"]}},"required":[],"additionalProperties":false},"access":{"classification":"read"},"freshness":{"status":"declared","value":{"mode":"scheduled","notes":"CARB republishes these map services irregularly and announces no cadence. Offset issuance changes as projects are verified; district, basin, and AB 617 boundaries change rarely."},"scope":"connector"},"entities":{"status":"not_declared"},"pagination":{"status":"not_declared"},"output":{"schema":{"status":"not_declared"},"units":{"status":"not_declared"},"coordinateReferenceSystem":{"status":"not_declared"}},"caveats":["Air-district and air-basin polygons name the agency with permitting jurisdiction over a location. They are not a permit, an entitlement, an approval, or a compliance determination.","AB 617 selection records where CARB directed community air monitoring, an emissions reduction program, or both. It is a program status, not a measured air-quality reading, and a null result means the point is outside all 19 selected communities rather than that air quality was assessed.","CARB offset projects are national, not California only. The forest layer publishes no state field, so a state filter cannot reach forest polygons; use coordinates instead.","Net credits issued is a NET figure and can be negative, which signals reversed or invalidated credits. Overlapping project ids frequently cover identical acreage, so credits and acreage must never be summed across records without deduplicating on geometry first.","Acreage is the CARB web-map GIS figure for the mapped polygon — cartographic, not surveyed or deeded. A forest offset project also carries a long-running management covenant whose terms live in the project documentation, not in this data.","Emissions inventory records (facility tonnages, criteria pollutants, toxics, health-risk screening scores) and cap-and-trade permit, auction, and compliance data are NOT exposed by this connector. They publish as rotating bulk files, undocumented JSONP, XLSX, and PDF, and are deferred to a later phase.","CARB publishes no API contract, versioning, or deprecation policy for these services, and arb.ca.gov sits behind a web application firewall that answers a rejected request with HTTP 200 and an HTML page. This connector detects that body and raises an error rather than reporting an empty result.","Reuse rests on the State of California statewide public-domain default; CARB publishes no dataset-level licence grant, so carry the attribution \"California Air Resources Board (CARB)\"."]}]},"caveats":["Air-district and air-basin polygons name the agency with permitting jurisdiction over a location. They are not a permit, an entitlement, an approval, or a compliance determination.","AB 617 selection records where CARB directed community air monitoring, an emissions reduction program, or both. It is a program status, not a measured air-quality reading, and a null result means the point is outside all 19 selected communities rather than that air quality was assessed.","CARB offset projects are national, not California only. The forest layer publishes no state field, so a state filter cannot reach forest polygons; use coordinates instead.","Net credits issued is a NET figure and can be negative, which signals reversed or invalidated credits. Overlapping project ids frequently cover identical acreage, so credits and acreage must never be summed across records without deduplicating on geometry first.","Acreage is the CARB web-map GIS figure for the mapped polygon — cartographic, not surveyed or deeded. A forest offset project also carries a long-running management covenant whose terms live in the project documentation, not in this data.","Emissions inventory records (facility tonnages, criteria pollutants, toxics, health-risk screening scores) and cap-and-trade permit, auction, and compliance data are NOT exposed by this connector. They publish as rotating bulk files, undocumented JSONP, XLSX, and PDF, and are deferred to a later phase.","CARB publishes no API contract, versioning, or deprecation policy for these services, and arb.ca.gov sits behind a web application firewall that answers a rejected request with HTTP 200 and an HTML page. This connector detects that body and raises an error rather than reporting an empty result.","Reuse rests on the State of California statewide public-domain default; CARB publishes no dataset-level licence grant, so carry the attribution \"California Air Resources Board (CARB)\"."]}