目前地图SDK支持的地图容器有六种,包括MapView、MapFragment、SupportMapFragment、TextureMapView、TextureMapFragment、TextureSupportMapFragment。以下介绍两种常用地图容器SupportMapFragment、MapView:
下面以SupportMapFragment为例简单介绍创建Map实例的步骤。
<fragment xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:map="http://schemas.android.com/apk/res-auto"
android:id="@+id/mapfragment_mapfragmentdemo"
class="com.huawei.hms.maps.SupportMapFragment"
android:layout_width="match_parent"
android:layout_height="match_parent"
map:cameraTargetLat="48.893478"
map:cameraTargetLng="2.334595"
map:cameraZoom="10" /> “Java”
public class SupportMapDemoActivity extends AppCompatActivity implements OnMapReadyCallback {
...
} “Kotlin”
class SupportMapDemoActivity : AppCompatActivity(),OnMapReadyCallback {
...
} 在初始化完成后,加载SupportMapFragment,并调用getMapAsync()来注册回调。
“Java” // 初始化SDK MapsInitializer.initialize(this); setContentView(R.layout.mapfragment_mapfragmentdemo); SupportMapFragment mSupportMapFragment; mSupportMapFragment = (SupportMapFragment) getSupportFragmentManager().findFragmentById(R.id.mapfragment_mapfragmentdemo); mSupportMapFragment.getMapAsync(this);
“Kotlin” // 初始化SDK MapsInitializer.initialize(this); setContentView(R.layout.mapfragment_mapfragmentdemo); var mSupportMapFragment: SupportMapFragment? = null mSupportMapFragment = supportFragmentManager.findFragmentById(R.id.mapfragment_mapfragmentdemo) as SupportMapFragment? mSupportMapFragment?.getMapAsync(this)
建议在用户同意隐私协议后再初始化SDK。
“Java”
public void onMapReady(HuaweiMap huaweiMap) {
Log.d(TAG, "onMapReady: ");
hMap = huaweiMap;
} “Kotlin”
override fun onMapReady(huaweiMap: HuaweiMap) {
Log.d(TAG, "onMapReady: ")
hMap = huaweiMap
} 
下面以MapView为例简单介绍创建Map实例的步骤。
<com.huawei.hms.maps.MapView xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:map="http://schemas.android.com/apk/res-auto"
android:id="@+id/mapview_mapviewdemo"
android:layout_width="match_parent"
android:layout_height="match_parent"
map:cameraTargetLat="48.893478"
map:cameraTargetLng="2.334595"
map:cameraZoom="10"/> “Java”
public class MapViewDemoActivity extends AppCompatActivity implements OnMapReadyCallback {
...
} “Kotlin”
class MapViewDemoActivity : AppCompatActivity(), OnMapReadyCallback {
...
} “Java” // 初始化SDK MapsInitializer.initialize(this); MapView mMapView; mMapView = findViewById(R.id.mapview_mapviewdemo); Bundle mapViewBundle = null; if (savedInstanceState != null) { mapViewBundle = savedInstanceState.getBundle("MapViewBundleKey"); } mMapView.onCreate(mapViewBundle); mMapView.getMapAsync(this);
“Kotlin”
// 初始化SDK
MapsInitializer.initialize(this);
private lateinit var mMapView: MapView
mMapView = findViewById(R.id.mapview_mapviewdemo)
var mapViewBundle: Bundle? = null
if (savedInstanceState != null) {
mapViewBundle = savedInstanceState.getBundle("MapViewBundleKey")
}
mMapView.onCreate(mapViewBundle)
mMapView.getMapAsync(this)
建议在用户同意隐私协议后再初始化SDK。
“Java”
public void onMapReady(HuaweiMap huaweiMap) {
Log.d(TAG, "onMapReady: ");
hMap = huaweiMap;
} “Kotlin”
override fun onMapReady(huaweiMap: HuaweiMap) {
Log.d(TAG, "onMapReady: ")
hMap = huaweiMap
} “Java”
private static final String MAPVIEW_BUNDLE_KEY = "MapViewBundleKey";
@Override
public void onSaveInstanceState(Bundle outState) {
super.onSaveInstanceState(outState);
Bundle mapViewBundle = outState.getBundle(MAPVIEW_BUNDLE_KEY);
if (mapViewBundle == null) {
mapViewBundle = new Bundle();
outState.putBundle(MAPVIEW_BUNDLE_KEY, mapViewBundle);
}
mMapView.onSaveInstanceState(mapViewBundle);
}
@Override
protected void onStart() {
super.onStart();
mMapView.onStart();
}
@Override
protected void onResume() {
super.onResume();
mMapView.onResume();
}
@Override
protected void onPause() {
super.onPause();
mMapView.onPause();
}
@Override
protected void onStop() {
super.onStop();
mMapView.onStop();
}
@Override
protected void onDestroy() {
super.onDestroy();
mMapView.onDestroy();
}
@Override
public void onLowMemory() {
super.onLowMemory();
mMapView.onLowMemory();
} “Kotlin”
companion object {
private const val MAPVIEW_BUNDLE_KEY = "MapViewBundleKey"
}
override fun onSaveInstanceState(outState: Bundle?) {
super.onSaveInstanceState(outState)
var mapViewBundle: Bundle? = outState?.getBundle(MAPVIEW_BUNDLE_KEY)
if (mapViewBundle == null) {
mapViewBundle = Bundle()
outState?.putBundle(MAPVIEW_BUNDLE_KEY, mapViewBundle)
}
mMapView.onSaveInstanceState(mapViewBundle)
}
override fun onStart() {
super.onStart()
mMapView.onStart()
}
override fun onResume() {
super.onResume()
mMapView.onResume()
}
override fun onPause() {
super.onPause()
mMapView.onPause()
}
override fun onStop() {
super.onStop()
mMapView.onStop()
}
override fun onDestroy() {
super.onDestroy()
mMapView.onDestroy()
}
override fun onLowMemory() {
super.onLowMemory()
mMapView.onLowMemory()
} 
自Android Map SDK 5.0.0.300起,初始化地图前,必须要设置“API密钥”。当前提供两种方式设置API密钥:
方式一:直接使用“agconnect-services.json”文件中api_key字段的API密钥。
“Java” // 在App主应用的程序入口类(即继承了android.app.Application的类),在覆写的onCreate()方法中调用该方法 public class MyApp extends Application { @Override public void onCreate() { super.onCreate(); // 设置API密钥 MapsInitializer.setApiKey("Your API key"); } }
“Kotlin” // 在App主应用的程序入口类(即继承了android.app.Application的类),在覆写的onCreate()方法中调用该方法 class MyApp : Application() { override fun onCreate() { super.onCreate() // 设置API密钥 MapsInitializer.setApiKey("Your API key") } }
“Java” @Override protected void onCreate(Bundle savedInstanceState) { Log.i(TAG, "onCreate: "); super.onCreate(savedInstanceState); // 在setContentView之前设置API密钥 MapsInitializer.setApiKey("Your API key"); setContentView(R.layout.basic_demo); }
“Kotlin” override fun onCreate(savedInstanceState: Bundle?) { Log.i(TAG, "onCreate: ") super.onCreate(savedInstanceState) // 在setContentView之前设置API密钥 MapsInitializer.setApiKey("Your API key") setContentView(R.layout.basic_demo) }