Cobertura expandida (experimental)

Este producto o función está en versión experimental (fase previa a la DG). Los productos y las funciones que se encuentran en la fase previa a la DG pueden tener asistencia limitada, y los cambios en estos productos y funciones podrían no ser compatibles con otras versiones de la fase previa a la DG. Las ofertas que se encuentran en la fase previa a la DG se rigen por las Condiciones Específicas del Servicio de Google Maps Platform. Para obtener más información, consulta las descripciones de la etapa de lanzamiento.

La API de Solar lanzará una función experimental que expandirá la cobertura a regiones que antes no se admitían, en función de modelos de aprendizaje automático aplicados a imágenes satelitales. Para acceder a los datos solares experimentales, establece el parámetro experiments en EXPANDED_COVERAGE y el parámetro requiredQuality en BASE.

Nota: Solo los datos de calidad BASE están disponibles en este experimento. Las llamadas a la API de Solar con experiments=EXPANDED_COVERAGE se descuentan un 100% durante la fase experimental. Para acceder a los datos de calidad de HIGH o MEDIUM, quita el parámetro experiments=EXPANDED_COVERAGE. Las llamadas no experimentales se facturarán a la tarifa estándar.

Los datos experimentales están disponibles para las solicitudes de buildingInsights y dataLayers. En las siguientes secciones, se describen ejemplos de solicitudes y respuestas.

Para mejorar de forma continua los datos y los modelos y satisfacer tus necesidades, el equipo de la API de Solar está solicitando comentarios sobre esta versión experimental. Para compartir tus comentarios, envía una respuesta en la Encuesta de experiencia del programa de pruebas de la API de Solar o informa un error en el Registrador de problemas de cobertura expandida de la API de Solar. Para obtener los anuncios más recientes, envía un correo electrónico a [e-mail] y únete al grupo de cobertura expandida de la API de Solar.

Estadísticas de edificios

El extremo buildingInsights proporciona estadísticas sobre la ubicación, las dimensiones y el potencial solar de un edificio. Para solicitar estadísticas de edificios, envía una solicitud GET de HTTP a:

https://solar.googleapis.com/v1/buildingInsights:findClosest?key=YOUR_API_KEY

Incluye los parámetros de la URL de tu solicitud que especifiquen las coordenadas de latitud y longitud de la ubicación y el nivel de calidad mínimo permitido en los resultados.

En el siguiente ejemplo, se solicita información de estadísticas de edificios para la ubicación en las coordenadas de latitud = 4.655719 y longitud = -74.128971. Para solicitar datos experimentales, establece los siguientes parámetros:

• requiredQuality = BASE
• experiments = EXPANDED_COVERAGE

Nota: Los datos de calidad de las imágenes BASE solo están disponibles si el parámetro experiments está configurado como EXPANDED_COVERAGE.

curl -X GET "https://solar.googleapis.com/v1/buildingInsights:findClosest?location.latitude=4.655719&location.longitude=-74.128971&requiredQuality=BASE&experiments=EXPANDED_COVERAGE&key=YOUR_API_KEY"

Esa solicitud produce una respuesta en formato JSON en el siguiente formato:

{
  "name": "buildings/ChIJW2GaKXecP44RaeGtGpQtk4Q",
  "center": {
    "latitude": 4.6557664,
    "longitude": -74.1289303
  },
  "imageryDate": {
    "year": 2024,
    "month": 2,
    "day": 19
  },
  "regionCode": "CO",
  "solarPotential": {
    "maxArrayPanelsCount": 351,
    "maxArrayAreaMeters2": 689.20776,
    "maxSunshineHoursPerYear": 1631.7008,
    "carbonOffsetFactorKgPerMwh": 122.99986,
    "wholeRoofStats": {
      "areaMeters2": 1078.406,
      "sunshineQuantiles": [
        562.9261,
        930.9767,
        1165.876,
        1221.8761,
        1333.0057,
        1485.7363,
        1563.2417,
        1593.266,
        1610.5652,
        1621.5986,
        1640.6102
      ],
      "groundAreaMeters2": 1050.76
    },
    "roofSegmentStats": [
      {
        "pitchDegrees": 38.58091,
        "azimuthDegrees": 41.91368,
        "stats": {
          "areaMeters2": 23.153826,
          "sunshineQuantiles": [
            582.9132,
            612.5797,
            673.3435,
            762.14233,
            899.41864,
            1031.1329,
            1103.8121,
            1135.5204,
            1150.2969,
            1158.215,
            1170.5475
          ],
          "groundAreaMeters2": 18.1
        },
        "center": {
          "latitude": 4.6554996,
          "longitude": -74.128966699999992
        },
        "boundingBox": {
          "sw": {
            "latitude": 4.655472,
            "longitude": -74.1290005
          },
          "ne": {
            "latitude": 4.6555371999999995,
            "longitude": -74.1289328
          }
        },
        "planeHeightAtCenterMeters": 2552.031
      },
      /.../
    ]
    "solarPanelConfigs": [
      {
        "panelsCount": 4,
        "yearlyEnergyDcKwh": 2609.5698,
        "roofSegmentSummaries": [
          {
            "pitchDegrees": 10.260736,
            "azimuthDegrees": 131.22626,
            "panelsCount": 1,
            "yearlyEnergyDcKwh": 652.84863,
            "segmentIndex": 6
          },
          {
            "pitchDegrees": 8.649131,
            "azimuthDegrees": 145.79407,
            "panelsCount": 1,
            "yearlyEnergyDcKwh": 652.3829,
            "segmentIndex": 11
          },
          {
            "pitchDegrees": 5.061984,
            "azimuthDegrees": 12.690001,
            "panelsCount": 2,
            "yearlyEnergyDcKwh": 1304.3383,
            "segmentIndex": 12
          }
        ]
      },
      /.../
    ]
    "panelCapacityWatts": 400,
    "panelHeightMeters": 1.879,
    "panelWidthMeters": 1.045,
    "panelLifetimeYears": 20,
    "buildingStats": {
      "areaMeters2": 1143.155,
      "sunshineQuantiles": [
        557,
        883.26263,
        1146.4794,
        1209.3063,
        1278.1102,
        1465.2921,
        1557.7494,
        1590.9565,
        1609.4994,
        1621.1909,
        1640.6102
      ],
      "groundAreaMeters2": 1089.35
    },
    "solarPanels": [
      {
        "center": {
          "latitude": 4.6560077,
          "longitude": -74.12885
        },
        "orientation": "PORTRAIT",
        "yearlyEnergyDcKwh": 653.14404,
        "segmentIndex": 12
      },
      /.../
    ]
    },
  "boundingBox": {
    "sw": {
      "latitude": 4.6554716,
      "longitude": -74.129243899999992
    },
    "ne": {
      "latitude": 4.6560513,
      "longitude": -74.128623900000008
    }
  },
  "imageryQuality": "BASE",
  "imageryProcessedDate": {
    "year": 2024,
    "month": 7,
    "day": 21
  }
}

Capas de datos

El extremo dataLayers proporciona información solar detallada para una región que rodea una ubicación especificada. El extremo muestra 17 archivos TIFF descargables, incluidos un modelo de superficie digital (DSM), una capa compuesta RGB (imágenes aéreas) y una capa de máscara que identifica los límites del análisis, entre otros.

En el siguiente ejemplo, se muestra la URL de una solicitud REST al método dataLayers:

https://solar.googleapis.com/v1/dataLayers:get?parameters

Incluye los parámetros de la URL de la solicitud que especifiquen lo siguiente:

• Coordenadas de latitud y longitud de la ubicación
• El radio (en metros) de la región que rodea la ubicación
• Es la calidad mínima permitida en los resultados.

Para solicitar datos experimentales, establece los siguientes parámetros:

• requiredQuality = BASE
• experiments = EXPANDED_COVERAGE

curl -X GET "https://solar.googleapis.com/v1/dataLayers:get?location.latitude=4.655719&location.longitude=-74.128971&radiusMeters=100&requiredQuality=BASE&experiments=EXPANDED_COVERAGE&key=YOUR_API_KEY"

Esa solicitud produce una respuesta JSON con el siguiente formato:

{
  "imageryDate": {
    "year": 2024,
    "month": 2,
    "day": 19
  },
  "imageryProcessedDate": {
    "year": 2024,
    "month": 7,
    "day": 21
  },
  "dsmUrl": "https://solar.googleapis.com/v1/geoTiff:get?id=YTYwZDUzYTMxNjVmMjFlYWNjZmMyYzcxYTNhNWQ2OWItZTM0ZWRjZTQwNTZjZWUyYTNiNWE2ZjU5OTVkYWJjNTM6RFNNOkJBU0U",
  "rgbUrl": "https://solar.googleapis.com/v1/geoTiff:get?id=MWU2NmYxNmU3M2JlYmY5NDJkZmVmMjQ0NDViMjFjYTgtZWVhYjRiN2U0YWJlNzM2Nzk1MzUxZTQ4YTgxNjZiM2M6UkdCOkJBU0U",
  "maskUrl": "https://solar.googleapis.com/v1/geoTiff:get?id=ZGU4NzhmNDg0YjE2OGYwYTdjN2EyYmVlMDQxYTM5NDMtNDk2NGQwNzBhMzAwYzBkYTEwZDNmYjgzNTk4ODkyY2I6TUFTSzpCQVNF",
  "annualFluxUrl": "https://solar.googleapis.com/v1/geoTiff:get?id=NmRiZDQ0NDFkNWE5NDU2Nzc2ZTU1Mzg0MDY0YzFhMWMtMDg2ZDMyZjVkYTMzMDhiZmI5NzM1MzY0YmRjZmFiM2I6QU5OVUFMX0ZMVVg6QkFTRQ",
  "monthlyFluxUrl": "https://solar.googleapis.com/v1/geoTiff:get?id=NTAyMDJkMTVmMjJiZGYyOTNiMDFhMWEzNDJkZjAwNTctZDRjMjY3ZjU1YjQ2ZjE4ZTNkNjE1YmU5NTlmOThlZjM6TU9OVEhMWV9GTFVYOkJBU0U",
  "hourlyShadeUrls": [
    "https://solar.googleapis.com/v1/geoTiff:get?id=NWNkZmM0NTcwYTE5ODQzMmI0MmQ1NDM4NzY4MTc5MzEtOWE0MTBjNDkwM2IxZjA0MmI1ZTNmNTg1NTY0MTNkZjI6SE9VUkxZX1NIQURFOkJBU0U",
    "https://solar.googleapis.com/v1/geoTiff:get?id=Y2YwNDY4MzQ1YzhkMjBlZjU5M2NiNDRmMmM0ODRiNTUtNjMwOWM2NDBjZmI5OTdkMDA3ZGQzOWY2YmI1ZTk2NWM6SE9VUkxZX1NIQURFOkJBU0U",
    /.../
  ],
  "imageryQuality": "BASE"
}

Para realizar una solicitud a la URL en la respuesta, agrega tu clave de API a la URL:

curl -X GET "https://solar.googleapis.com/v1/geoTiff:get?id=YTYwZDUzYTMxNjVmMjFlYWNjZmMyYzcxYTNhNWQ2OWItZTM0ZWRjZTQwNTZjZWUyYTNiNWE2ZjU5OTVkYWJjNTM6RFNNOkJBU0U&key=YOUR_API_KEY"

Con la excepción de la capa RGB, todos los archivos TIFF se mostrarán como imágenes en blanco en las aplicaciones de visor de imágenes. Para ver los archivos TIFF descargados, impórtalos a un software de aplicación de mapas, como QGIS.

La especificación completa de esta solicitud y respuesta se encuentra en la documentación de referencia.

Nota: Las URLs de respuesta solo están activas durante una hora después de la solicitud inicial. Para acceder a las URLs después de este período, debes volver a enviar una solicitud al extremo dataLayers.