Passer de l'API Google Earth Engine Solar à Google Maps Platform API Solar:
- Activez l'API Google Maps Platform Solar dans votre projet sur le cloud.
- Créez une clé et limitez-la à l'API GMP Solar.
- Mettez à jour votre code à l'aide de la méthode pour chaque étape les instructions ci-dessous.
Affichage comparatif
API Solar (nouvelle) ![]() |
API Earth Engine Solar (obsolète) ![]() |
|
---|---|---|
État du lancement | Lancé | Pilote (obsolète) |
Accès | ||
Mécanisme | un compte Google Cloud via la console Cloud, en activant l'API Solar et en la gérant via la section "Google Maps Platform" ; | compte Google Cloud via la console Cloud, en activant l'API Earth Engine Solar |
Qui | Public | Accès contrôlé |
Niveau | Auto-provisionné | Accès manuel aux projets Cloud |
Authentification | Clé API et OAuth | Clé API |
Tarifs | ||
Stratégie | Paiement à l'usage | 100% remise |
Niveaux | Pour 1 000 requêtes, avec un prix décroissant en fonction du volume | – |
Points de terminaison | Prix par point de terminaison différents | – |
Cloud | ||
Surveillance | Cloud Monitoring sous "Google Maps Platform" ; | Cloud Monitoring sous "API et services" ; |
Quota | RPM (requête par minute) et QPH (requête par heure) | Annuel |
Journalisation | Cloud Logging (facultatif) | Cloud Logging (facultatif) |
Facturation | Compte de facturation Cloud | - |
Assistance | Compatibilité complète avec Google Maps Platform avec les SLO/contrats de niveau de service | Limitée, par e-mail |
API | ||
Nom d'hôte | https://solar.googleapis.com/v1/ (REST) |
https://earthenginesolar.googleapis.com/v1/ (REST) |
Méthodes |
|
|
Réponse | Aucune modification par rapport au pilote | – |
solarInfo |
Rayon ≤ 100 m | Rayon ≤ 100 m |
Couverture | ||
Zone | Monde | Monde |
Qualité des données | HIGH /MEDIUM |
HIGH /MEDIUM |
Type de bâtiment | Tout bâtiment associé à une adresse ET figurant dans la couverture des images de l'API Solar | Tout bâtiment associé à une adresse ET figurant dans la couverture des images de l'API Solar |
Conditions d'utilisation | ||
Conditions d'utilisation | Conditions d'utilisation de Google Maps Platform | Termes de Google Earth Engine |
Procédure détaillée
Configurer votre projet Google Cloud
Instructions: Configurer votre environnement Google Cloud projet.
Seuls certains rôles peuvent créer un projet Cloud ; si vous ne parvenez pas à créer de projet, contactez votre administrateur de l'organisation.
Vous pouvez également utiliser un projet Cloud existant. Pour en savoir plus, consultez la section Premiers pas avec Google Maps Platform.
Configurer votre compte de facturation
Instructions: Gérer votre facturation Compte.
Vous pouvez utiliser un projet Cloud existant avec un compte de facturation existant.
Obtenir une clé API ou utiliser un jeton OAuth
Après avoir configuré votre projet Google Cloud, vous devez créer et sécuriser votre API Clé permettant d'utiliser l'API Solar, comme décrit dans la section Utiliser l'API Clés. Vous pouvez également créer un jeton OAuth comme décrit dans la section Utiliser OAuth.
Utiliser l'API Solar
- Envoyez des requêtes GET aux nouveaux points de terminaison : https://solar.googleapis.com
- Notez que certains noms de méthodes API ont été modifiés:
<ph type="x-smartling-placeholder">
- </ph>
buildings:findClosest
→buildingInsights:findClosest
solarinfo:get
→dataLayers:get
Essai rapide: utilisez la clé API enregistrée à l'étape précédente et remplacez
YOUR_API_KEY
dans l'exemple de requête ci-dessous, avant de charger l'URL dans votre
navigateur:
https://solar.googleapis.com/v1/dataLayers:get?location.latitude=37.2746464&location.longitude=-121.7530949&radius_meters=10&key=YOUR_API_KEY
Réponse pour la version preview d'origine
Pour la version preview d'origine du 9 mai 2023, les URL de la réponse se trouvent au format au format suivant:
https://earthengine.googleapis.com/v1alpha/projects/sunroof-api/thumbnails/THUMBNAIL_ID:getPixels
L'extrait de code suivant est un exemple de réponse:
{ "imageryDate": { "year": 2015, "month": 8, "day": 8 }, "imageryProcessedDate": { "year": 2021, "month": 2, "day": 15 }, "dsmUrl": "https://earthengine.googleapis.com/v1alpha/projects/geo-solar-api/thumbnails/fbde33e9cd16d5fd10d19a19dc580bc1-8614f599c5c264553f821cd034d5cf32:getPixels", "rgbUrl": "https://earthengine.googleapis.com/v1alpha/projects/geo-solar-api/thumbnails/91ed3551f2d0abee20af35e07bd0c927-c96c59e80cf1fc1dc86cf59fc8ec86ba:getPixels", "maskUrl": "https://earthengine.googleapis.com/v1alpha/projects/geo-solar-api/thumbnails/e4051553dba6870c03d855ae82c30b7e-7cc8ae6ce7c73f219e3c1924e5c17fc6:getPixels", "annualFluxUrl": "https://earthengine.googleapis.com/v1alpha/projects/geo-solar-api/thumbnails/9b0f87f49d778a65c9e27ff936e6dbba-b90be2fe80d25abd4c9e8c4dc809f763:getPixels", "monthlyFluxUrl": "https://earthengine.googleapis.com/v1alpha/projects/geo-solar-api/thumbnails/90e7cca77402f14809e349937f0a0be8-94fafeb4ef42d72f1b3c0652a1cb5518:getPixels", "hourlyShadeUrls": [ "https://earthengine.googleapis.com/v1alpha/projects/geo-solar-api/thumbnails/dcd276e4782aef4ff1b230b781736d37-e193b231ce57a03449afc3e21cf6783b:getPixels", ... ] }
Pour envoyer une requête à une URL dans la réponse, incluez l'URL complète dans le champ requête.
La spécification complète de cette requête et de cette réponse se trouve dans la documentation de référence documentation.
Écrivez une application compatible avec les deux formats de réponse
Vous pouvez désormais écrire une application qui gère à la fois l'aperçu d'origine et la version actuelle et des formats de réponse personnalisés.
La principale différence entre les deux réponses, en dehors de l'URL elle-même, est que vous devez transmettre une clé API à une requête qui accède aux URL depuis le nouveau format de réponse. Si vous omettez cette clé, la requête échoue.
Par exemple, vous pouvez ajouter le code suivant à votre application pour examiner l'URL et gérer chaque version correctement:
JavaScript
/** * Function to examine a response URL and to append the API key to the * URL if it is in the new format. */ function prepareGetGeoTiffUrl(geoTiffUrl, apiKey) { if (geoTiffUrl.match("solar.googleapis.com")) { let url = new URL(geoTiffUrl); url.searchParams.set('apiKey', apiKey); return url.toString(); } return geoTiffUrl; }
Python
# Functions to examine a response URL and to append the API key to the # URL if it is in the new format. def add_api_key_to_url(base_url: str, api_key: str) -> str: '''Formats URL that currently lacks an API key to use the one provided.''' return base_url + "&key=" +api_key; def prepare_geo_tiff_url(base_url: str, api_key: str) -> str: '''Prepares URL from GetDataLayers depending on API being called. If the geoTIFF url from GetDataLayers is for the solar API GetGeoTiff endpoint, append the API key. Otherwise return the URL as is. ''' if re.search("solar.googleapis.com", geo_tiff_url): return add_api_key_to_url(geo_tiff_url, api_key) return geo_tiff_url
Java
/ **Adds API key to a URL. /* private String addApiKeyToUrl(String geoTiffUrl, String apiKey) { return geoTiffUrl + "&key=" + apiKey; } / ** *Function to examine a response URL and to append the API key to the *URL if it is in the new format. /* private String prepareGetGeoTiffUrl(String geoTiffUrl, String apiKey) { Pattern pattern = Pattern.compile("solar.googleapis.com"); Matcher matcher = pattern.matcher(geoTiffUrl); if (matcher.find()) { return addApiKeyToUrl(geoTiffUrl, apiKey); } else { return geoTiffUrl; } }
Surveiller
Niveau Projet |
Au niveau du compte de facturation
|
![]() |
![]() |
Conseils utiles
- Quota: consommation réglable (au lieu d'une consommation annuelle qui disparaîtra)
<ph type="x-smartling-placeholder">
- </ph>
- Actuellement quota qui sera remplacé par QPM
- Bonnes pratiques: définir un quota côté client et envoyer des alertes
- Tarifs:
<ph type="x-smartling-placeholder">
- </ph>
- Paiement à l'usage
- Les réponses 404 NOT_FOUND, lorsque la zone géographique n'est pas dans la plage de couverture, ne seront pas facturés, mais seront comptabilisés dans le quota
- Conditions d'utilisation générales: Conditions d'utilisation de Google Maps Platform