Realiza una solicitud de capas de datos

El extremo dataLayers proporciona información solar detallada sobre una región que rodea una ubicación específica. El extremo muestra 17 archivos TIFF descargables, incluidos los siguientes:

  • Modelo de superficie digital (DSM)
  • Capa compuesta RGB (imágenes aéreas)
  • Una capa de máscara que identifica los límites del análisis
  • Flujo solar anual o rendimiento anual de una superficie determinada
  • Flujo solar mensual o rendimiento mensual de una superficie determinada
  • Tono por hora (24 horas)

Para obtener más información sobre cómo la API de Solar define el flujo, consulta los conceptos de la API de Solar.

Información acerca de las solicitudes de capas de datos

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

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

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

  • Coordenadas de latitud y longitud de la ubicación
  • El radio de la región que rodea la ubicación
  • Subconjunto de los datos que se mostrarán (DSM, RGB, máscara, flujo anual o flujo mensual)
  • La calidad mínima permitida en los resultados
  • La escala mínima de los datos que se mostrarán, en metros por píxeles

Ejemplo de solicitud de capas de datos

En el siguiente ejemplo, se solicita toda la información de las estadísticas de edificios en un radio de 100 metros para la ubicación en las coordenadas de latitud = 37.4450 y longitud = -122.1390:

Clave de API

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/dataLayers:get?location.latitude=37.4450&location.longitude=-122.1390&radiusMeters=100&view=FULL_LAYERS&requiredQuality=HIGH&pixelSizeMeters=0.5&key=YOUR_API_KEY"

También puedes realizar solicitudes HTTP pegando la URL de la solicitud cURL en la barra de URL de tu navegador. Pasar la clave de API te proporciona mejores capacidades de uso y análisis, y un mejor control de acceso a los datos de respuesta.

Token de OAuth

Nota: Este formato es solo para un entorno de pruebas. Para obtener más información, consulta Usa OAuth.

Para realizar una solicitud a la URL en la respuesta, pasa el nombre del proyecto de facturación y el token de OAuth:

curl -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "X-Goog-User-Project: PROJECT_NUMBER_OR_ID" \
  "https://solar.googleapis.com/v1/dataLayers:get?location.latitude=37.4450&location.longitude=-122.1390&radius_meters=100&required_quality=HIGH"
        

La API muestra las URLs en el siguiente formato:

https://solar.googleapis.com/v1/solar/geoTiff:get?id=HASHED_ID

Ejemplo de respuesta

La solicitud produce una respuesta JSON con el siguiente formato:

{
  "imageryDate": {
    "year": 2019,
    "month": 7,
    "day": 9
  },
  "imageryProcessedDate": {
    "year": 2022,
    "month": 3,
    "day": 21
  },
  "dsmUrl": "https://solar.googleapis.com/v1/geoTiff:get?id=14f82e6931a8c33fc31ab8378e51804a-852f4ca7f056addda5b8fcb93e02c2fd",
  "rgbUrl": "https://solar.googleapis.com/v1/geoTiff:get?id=bf769c43d72eb85493b20df583bc0c95-d13126638efaa89e44951abc8664d6a3",
  "maskUrl": "https://solar.googleapis.com/v1/geoTiff:get?id=ed089240efc78e417c96a945460830ef-e666758b7cc183f82d1c7b7a891f858b",
  "annualFluxUrl": "https://solar.googleapis.com/v1/geoTiff:get?id=aaa2637073d62cc7331d067eb7080bbe-f94eab79915f66759f5265b2ff8b1ad4",
  "monthlyFluxUrl": "https://solar.googleapis.com/v1/geoTiff:get?id=d1608d342a3d0393b5decd063d330271-2a2e27504a2009cad1f1f3d2b471bcd3",
  "hourlyShadeUrls": [
    "https://solar.googleapis.com/v1/geoTiff:get?id=541c2f32b936f190f7562309ea1d60fc-432bf94bcd0dc918f0c828d07aa00e7c",
    "https://solar.googleapis.com/v1/geoTiff:get?id=4eb7a0b9c0f34e0e746816d0f3085274-4794b9eb35ab18ad4fbe2c3ee59f151d",
    ...
  ],
  "imageryQuality": "HIGH"
}

Accede a los datos de respuesta

El acceso a los datos a través de las URLs de respuesta requiere autenticación adicional. Si usas una clave de autenticación, debes agregar tu clave de API a la URL. Si usas la autenticación de OAuth, debes agregar encabezados de OAuth.

Clave de API

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/solar/geoTiff:get?id=fbde33e9cd16d5fd10d19a19dc580bc1-8614f599c5c264553f821cd034d5cf32&key=YOUR_API_KEY"

También puedes realizar solicitudes HTTP pegando la URL de la solicitud cURL en la barra de URL de tu navegador. Pasar la clave de API te proporciona mejores capacidades de uso y análisis, y un mejor control de acceso a los datos de respuesta.

Token de OAuth

Para realizar una solicitud a la URL en la respuesta, pasa el nombre del proyecto de facturación y el token de OAuth:

curl -X GET \
-H 'X-Goog-User-Project: PROJECT_NUMBER_OR_ID' \
-H "Authorization: Bearer $TOKEN" \
"https://solar.googleapis.com/v1/solar/geoTiff:get?id=fbde33e9cd16d5fd10d19a19dc580bc1-8614f599c5c264553f821cd034d5cf32"
        

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

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