Android Studio Google Maps 無法載入：API Key 與網路配置排查

現象：地圖空白，Logcat 提示連線伺服器失敗

核心檢查清單

1. API Key 正確性
   • Google Cloud Console → APIs & Services → Credentials → 建立/確認 Android 限制金鑰。
   • 套件名稱與 SHA-1 指紋（./gradlew signingReport）必須完全匹配。
   • AndroidManifest.xml 中 <meta-data android:name="com.google.android.geo.API_KEY" android:value="YOUR_KEY"/>。
2. 啟用 Maps SDK：Console 中搜尋「Maps SDK for Android」並啟用。
3. 網路權限：

   <uses-permission android:name="android.permission.INTERNET"/>
   <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>

4. Google Play Services 版本：模擬器/真機需安裝最新 Play Services（模擬器選擇 Google APIs 映像）。
5. 網路連通性：中國大陸需科學上網或使用代理，否則無法訪問 Google 地圖伺服器。
6. Build Config：build.gradle 依賴 implementation 'com.google.android.gms:play-services-maps:18.2.0'（版本視專案而定）。

快速驗證

在 onMapReady(GoogleMap map) 回調中加入：

if (map != null) {
    map.addMarker(new MarkerOptions().position(new LatLng(0,0)).title("Test"));
    map.moveCamera(CameraUpdateFactory.newLatLngZoom(new LatLng(0,0), 2));
}

若仍空白，過濾 Logcat 關鍵字 GoogleMap、API_KEY、Auth 查看具體錯誤碼。參考 完整配置教程。