Fazer uma solicitação de camadas de dados

O endpoint dataLayers fornece informações solares detalhadas para uma região ao redor de um local especificado. O endpoint retorna 17 arquivos TIFF para download, incluindo:

  • Modelo de superfície digital (DSM)
  • Camada composta RGB (imagens aéreas)
  • Camada de máscara que identifica os limites da análise
  • Fluxo solar anual, ou a produção anual de uma determinada superfície
  • Fluxo solar mensal, ou a produção mensal de uma determinada superfície
  • Sombreamento por hora (24 horas)

Para mais informações sobre como a API Solar define fluxo, consulte Conceitos da API Solar.

Sobre as solicitações de camadas de dados

O exemplo a seguir mostra o URL de uma solicitação REST para o método dataLayers:

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

Inclua os parâmetros do URL da solicitação que especificam o seguinte:

  • Coordenadas de latitude e longitude do local
  • O raio da região ao redor do local
  • O subconjunto dos dados a serem retornados (DSM, RGB, máscara, fluxo anual ou fluxo mensal)
  • A qualidade mínima permitida nos resultados
  • A escala mínima de dados a serem retornados, em metros por pixels

Exemplo de solicitação de camadas de dados

O exemplo a seguir solicita todas as informações de insights de construção em um raio de 100 metros para o local nas coordenadas de latitude = 37.4450 e longitude = -122.1390:

Chave de API

Para fazer uma solicitação ao URL na resposta, anexe sua chave de API ao 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"

Você também pode fazer solicitações HTTP colando o URL na solicitação cURL na barra de URL do seu navegador. Ao transmitir a chave de API, você tem melhores recursos de uso e análise, além de melhor controle de acesso aos dados de resposta.

Token OAuth

Observação:esse formato é apenas para ambientes de teste. Para mais informações, consulte Usar o OAuth.

Para fazer uma solicitação ao URL na resposta, transmita o nome do projeto de faturamento e o token 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"
        

A API retorna URLs no seguinte formato:

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

Exemplo de resposta

A solicitação produz uma resposta JSON no 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"
}

Acessar dados de resposta

O acesso a dados por URLs de resposta requer autenticação adicional. Se você usar uma chave de autenticação, anexe sua chave de API ao URL. Se você usa a autenticação OAuth, é necessário adicionar cabeçalhos OAuth.

Chave de API

Para fazer uma solicitação ao URL na resposta, anexe sua chave de API ao URL:

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

Você também pode fazer solicitações HTTP colando o URL na solicitação cURL na barra de URL do seu navegador. Ao transmitir a chave de API, você tem melhores recursos de uso e análise, além de melhor controle de acesso aos dados de resposta.

Token OAuth

Para fazer uma solicitação ao URL na resposta, transmita o nome do projeto de faturamento e o token 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"
        

Com exceção da camada RGB, todos os arquivos TIFF são exibidos como imagens em branco nos aplicativos visualizador de imagens. Para conferir os arquivos TIFF transferidos por download, importe-os em um software de aplicativo de mapeamento, como o QGIS.

A especificação completa dessa solicitação e resposta está na documentação de referência.