目录

创建地图实例

地图容器

目前地图SDK支持的地图容器有六种,包括MapView、MapFragment、SupportMapFragment、TextureMapView、TextureMapFragment、TextureSupportMapFragment。以下介绍两种常用地图容器SupportMapFragment、MapView:

[h2]SupportMapFragment

下面以SupportMapFragment为例简单介绍创建Map实例的步骤。

  1. 在Activity的布局文件(例如:activity_main.xml)中添加一个Fragment,并通过布局文件设置地图的属性。

    <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" />

  2. 要在应用程序中使用地图,您需要实现OnMapReadyCallback接口。

    示例代码如下:
    “Java”
    public class SupportMapDemoActivity extends AppCompatActivity implements OnMapReadyCallback {
       ...
    }
    “Kotlin”
    class SupportMapDemoActivity : AppCompatActivity(),OnMapReadyCallback { 
       ... 
    }

  3. 在加载地图前先初始化SDK,例如在Activity的onCreate方法中。

    初始化SDK有2种方式:

    在初始化完成后,加载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。

  4. 在onMapReady回调中获取HuaweiMap对象。

    示例代码如下:
    “Java”
    public void onMapReady(HuaweiMap huaweiMap) {
        Log.d(TAG, "onMapReady: ");     
        hMap = huaweiMap;
    }
    “Kotlin”
    override fun onMapReady(huaweiMap: HuaweiMap) {
        Log.d(TAG, "onMapReady: ")
        hMap = huaweiMap
    }

  5. 运行您刚完成的工程就可以在您的App中看到地图了。运行后的效果如下图所示:

[h2]MapView

下面以MapView为例简单介绍创建Map实例的步骤。

  1. 在Activity的布局文件中添加一个MapView,并通过XML文件设置地图的属性。

    <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"/>

  2. 要在应用程序中使用地图,您需要实现OnMapReadyCallback接口:

    示例代码如下:
    “Java”
    public class MapViewDemoActivity extends AppCompatActivity implements OnMapReadyCallback {
       ...
    }
    “Kotlin”
    class MapViewDemoActivity : AppCompatActivity(), OnMapReadyCallback { 
       ... 
    }

  3. 在Activity的onCreate()方法中先初始化SDK,然后加载MapView,并调用getMapAsync()来注册回调。

    示例代码如下:
    “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。

  4. 在onMapReady回调中获取HuaweiMap对象。

    示例代码如下:
    “Java”
    public void onMapReady(HuaweiMap huaweiMap) {
        Log.d(TAG, "onMapReady: ");     
        hMap = huaweiMap; 
    }
    “Kotlin”
    override fun onMapReady(huaweiMap: HuaweiMap) {
        Log.d(TAG, "onMapReady: ")
        hMap = huaweiMap
    }

  5. 在Activity/Fragment的onStart()、onResume()、onPause()、onStop()、onDestroy()、onSaveInstanceState(Bundle outState)和onLowMemory()方法中调用MapView对应的方法。

    示例代码如下:
    “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()
    }

    MapView创建的时候,需要至少保证重写Activity/Fragment的onDestroy()方法,使其能回调到MapView生命周期的onDestroy()方法,才可以保证地图不会内存泄漏。另外,在ListView/RecyclerView这种多实体中创建地图的情况下,需要自行在销毁的时候调用各个实体的onDestroy()方法,不然也可能会导致内存泄漏。

  6. 运行您刚完成的工程就可以在您的App中看到地图了。运行后的效果如下图所示:

设置API密钥

自Android Map SDK 5.0.0.300起,初始化地图前,必须要设置“API密钥”。当前提供两种方式设置API密钥:

方式一:直接使用“agconnect-services.json”文件中api_key字段的API密钥。

方式二:调用接口MapsInitializer.setApiKey(String apiKey)设置API密钥。
  • 在您的工程入口类设置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")
        }
    }
  • 在Fragment或者MapView设置API密钥。
    示例代码如下:
    “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)
    }