Plugin e Canali Nativi

PlatformException(GoogleMapException, API key not specified in AndroidManifest / AppDelegate). – Flutter MAPS_API_KEY_MISSING

MAPS_API_KEY_MISSING

Il widget `GoogleMap` genera una schermata nera o eccezione nativa perché il metadato `com.google.android.geo.API_KEY` non è presente nell'AndroidManifest o Info.plist.

Categoria: FlutterGruppo: Plugin e Canali NativiConfidenza: altaUltimo aggiornamento: 19-08-2026Letto 1 volta

Cosa significa questo errore?

Il widget `GoogleMap` genera una schermata nera o eccezione nativa perché il metadato `com.google.android.geo.API_KEY` non è presente nell'AndroidManifest o Info.plist.

Messaggio originale

PlatformException(GoogleMapException, API key not specified in AndroidManifest / AppDelegate).

Contesto e parole chiave

Alias

  • Google Maps Flutter error
  • GoogleMapException API key missing

Messaggi alternativi

  • chiave API Google Maps non specificata nel manifest

Prodotti

  • Flutter SDK / Dart VM / Flutter Framework / Gradle / CocoaPods

Piattaforme

  • Android
  • iOS
  • Linux
  • macOS
  • Web
  • Windows

Parole chiave

  • dart
  • errore-flutter-google-maps-api-key-missing
  • flutter
  • flutter.plugin.google-maps-api-key-missing
  • MAPS_API_KEY_MISSING
  • Plugin e Canali Nativi
  • widget

Cause possibili

Origine del problema per Flutter: chiave API Google Maps mancante (PlatformException)

Il widget `GoogleMap` genera una schermata nera o eccezione nativa perché il metadato `com.google.android.geo.API_KEY` non è presente nell'AndroidManifest o Info.plist.

molto comune

Diagnosi

Diagnostica Flutter per Flutter: chiave API Google Maps mancante (PlatformException)

Eseguire flutter doctor con flag verbose ed esaminare l'output di debug a console.

Come leggere il risultato. Evidenzia discrepanze nelle toolchain Android/iOS, plugin mancanti o configurazioni SDK errate.

flutter
flutter doctor -v

Risoluzione

Procedura di risoluzione per Flutter: chiave API Google Maps mancante (PlatformException)

Difficoltà: facileRischio: basso

Applicare la correzione al codice Dart o alla configurazione di build secondo la documentazione ufficiale Flutter.

  1. Verificare i vincoli di layout o la gerarchia dei widget
  2. Eseguire una pulizia della cache di build con flutter clean
  3. Aggiornare le dipendenze con flutter pub get
flutter
flutter clean && flutter pub get

Domande frequenti

Come risolvere il codice o problema MAPS_API_KEY_MISSING in Flutter?

Il widget `GoogleMap` genera una schermata nera o eccezione nativa perché il metadato `com.google.android.geo.API_KEY` non è presente nell'AndroidManifest o Info.plist.

Approfondimenti

Schede correlate