L'API Map Management è un'API RESTful che puoi utilizzare per gestire in modo programmatico le risorse di personalizzazione delle mappe basate su cloud. Con questa API puoi definire l'aspetto visivo delle tue mappe, gestire le identità delle mappe e associare stili e set di dati personalizzati a varianti di mappe specifiche, il tutto senza utilizzare la console Cloud.
L'API Map Management è progettata per gli sviluppatori che vogliono eseguire la gestione su larga scala delle configurazioni delle mappe o integrare lo stile di mappa nei propri workflow automatizzati e strumenti interni.
Risorse principali
- StyleConfig: contiene la rappresentazione JSON di uno stile di mappa. Questo definisce i colori, la visibilità e la densità degli elementi della mappa.
- MapConfig: rappresenta un'identità della mappa univoca (ID mappa). Funge da contenitore per le impostazioni di stile e funzionalità come l'ottimizzazione dei PDI o l'appiattimento degli edifici.
- MapContextConfig: associa un
StyleConfig(e, facoltativamente, uno o più set di dati) aMapVariantsspecifici all'interno di unMapConfig.
Canali di controllo delle versioni dell'API
L'API di gestione delle mappe utilizza il controllo delle versioni basato sui canali per fornire un percorso chiaro dalle funzionalità sperimentali alla disponibilità generale stabile.
- v2alpha (sperimentale): contiene le funzionalità sperimentali più recenti. Le funzionalità di questo canale potrebbero cambiare senza preavviso e non sono consigliate per l'uso in produzione.
- v2beta (anteprima): contiene funzionalità stabili e in preparazione per la disponibilità generale. Questo canale è adatto all'adozione anticipata e ai test negli ambienti di pre-produzione.
- v2 (disponibilità generale): contiene funzionalità completamente supportate e pronte per la produzione.
La maggior parte delle funzionalità della v2 è disponibile sia negli endpoint v2alpha che v2beta
durante le rispettive fasi di implementazione. Per i nuovi utenti, Google consiglia
di iniziare con l'endpoint v2beta.
Autenticazione
Puoi utilizzare solo OAuth 2.0 per l'autenticazione con l'API Map Management, che non supporta le chiavi API. Per saperne di più, consulta Utilizza OAuth.
Limitazioni
- Ruoli sviluppatore: per utilizzare l'API Map Management, devi disporre delle autorizzazioni IAM necessarie per gestire le risorse di Google Maps Platform all'interno del tuo progetto Google Cloud.
- Ambito delle risorse: questa API si concentra sulla gestione delle risorse di stile della mappa basate sul cloud. Altre configurazioni di Google Maps Platform potrebbero comunque richiedere la console Cloud.
Costi
Non è previsto alcun costo per l'utilizzo dell'API Map Management. Le chiamate API vengono visualizzate nella pagina Fatturazione di Cloud Console, ma gli addebiti saranno pari a 0 $. Tuttavia, le richieste sono vincolate come segue:
- 3 QPS (query al secondo)
- 180 QPM (query al minuto) per un progetto, aggiornate ogni minuto
- 100.000 QPD (query al giorno) per un progetto, aggiornate ogni giorno
Vedi Utilizzo e fatturazione.