# Power grid proximity: transmission lines near any site

**Use case:** 

Screen sites for grid access: nearest in-service transmission line, distance, voltage kV, owner, planned-line flag and a HIGH/MEDIUM/LOW tier. HIFLD data.

## Input

```json
{
  "assets": [
    {
      "lat": 39.7392,
      "lon": -104.9903,
      "label": "Denver site"
    },
    {
      "lat": 33.4484,
      "lon": -112.074,
      "label": "Phoenix site"
    }
  ],
  "radiusMiles": 5,
  "includeSubstations": true,
  "includePowerPlants": true,
  "includePlanned": true,
  "maxResults": 500
}
```

## Output

```json
{
  "asset_label": {
    "label": "Asset label",
    "format": "string"
  },
  "grid_tier": {
    "label": "Grid access tier",
    "format": "string"
  },
  "nearest_line_distance_miles": {
    "label": "Nearest line distance (mi)",
    "format": "number"
  },
  "nearest_line_voltage_kv": {
    "label": "Nearest line voltage (kV)",
    "format": "number"
  },
  "nearest_line_owner": {
    "label": "Nearest line owner",
    "format": "string"
  },
  "lines_within_radius": {
    "label": "Lines within radius",
    "format": "integer"
  },
  "nearest_substation_name": {
    "label": "Nearest substation name",
    "format": "string"
  },
  "nearest_substation_distance_km": {
    "label": "Nearest substation distance (km)",
    "format": "number"
  },
  "nearest_substation_max_voltage": {
    "label": "Nearest substation max voltage (kV)",
    "format": "number"
  },
  "substations_within_radius": {
    "label": "Substations within radius",
    "format": "integer"
  },
  "nearest_power_plant_name": {
    "label": "Nearest power plant name",
    "format": "string"
  },
  "nearest_power_plant_distance_km": {
    "label": "Nearest power plant distance (km)",
    "format": "number"
  },
  "nearest_power_plant_capacity_mw": {
    "label": "Nearest power plant capacity (MW)",
    "format": "number"
  },
  "nearest_power_plant_fuel": {
    "label": "Nearest power plant fuel",
    "format": "string"
  },
  "power_plants_within_radius": {
    "label": "Power plants within radius",
    "format": "integer"
  },
  "error": {
    "label": "Error",
    "format": "string"
  }
}
```

## About this Actor

This example demonstrates how to use [Power Grid Proximity Screener - Transmission Lines Near Sites](https://apify.com/malonestar/hifld-grid-proximity-screener) with a specific input configuration. Visit the [Actor detail page](https://apify.com/malonestar/hifld-grid-proximity-screener) to learn more, explore other use cases, and run it yourself.