Panoramica dell'API Map Management

L'API di gestione delle mappe è un'API RESTful che puoi utilizzare per gestire in modo programmatico le risorse di personalizzazione delle mappe basata su cloud. Con questa API puoi definire l'aspetto visivo delle tue mappe, gestire gli ID mappa e associare stili e set di dati personalizzati a varianti di mappa specifiche, il tutto senza utilizzare la console Cloud.

L'API di gestione delle mappe è progettata per gli sviluppatori che vogliono eseguire la gestione su larga scala delle configurazioni delle mappe o integrare lo stile di mappa nei propri flussi di lavoro 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à mappa univoca (ID mappa). Funge da contenitore per le impostazioni di stile e le funzionalità come l'ottimizzazione dei PDI o l'appiattimento degli edifici.
  • MapContextConfig: associa un StyleConfig (e facoltativamente uno o più set di dati) a un MapVariants specifico all'interno di un MapConfig.

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 possono cambiare senza preavviso e non sono consigliate per l'uso in produzione.
  • v2beta (anteprima): contiene funzionalità stabili e in fase di preparazione per la disponibilità generale. Questo canale è adatto per l'adozione anticipata e i test negli ambienti di pre-produzione.
  • v2 (disponibilità generale): contiene funzionalità completamente supportate e pronte per la produzione.

La maggior parte delle funzionalità della versione 2 è disponibile sia per gli endpoint v2alpha sia per gli endpoint 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 degli sviluppatori: 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 delle mappe basate su cloud. Altre configurazioni di Google Maps Platform potrebbero comunque richiedere la console Cloud.

Costi

L'utilizzo dell'API Map Management non prevede costi. Le chiamate API vengono visualizzate nella pagina Fatturazione della console Cloud, 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

Consulta Utilizzo e fatturazione.