显示基本地图

显示基本地图的图片。

下例会使用 Maps SDK for Android 中的 SupportMapFragment 来创建地图。

如需了解详情,请参阅相关文档

开始使用

您必须先配置开发环境,然后才能试用该示例代码。如需了解详情,请参阅 Maps SDK for Android 代码示例

查看代码

Kotlin



class BasicMapDemoActivity : AppCompatActivity(), OnMapReadyCallback {

    val SYDNEY = LatLng(-33.862, 151.21)
    val ZOOM_LEVEL = 13f

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_basic_map_demo)
        val mapFragment : SupportMapFragment? =
                supportFragmentManager.findFragmentById(R.id.map) as? SupportMapFragment
        mapFragment?.getMapAsync(this)
    }

    /**
     * This is where we can add markers or lines, add listeners or move the camera. In this case,
     * we just move the camera to Sydney and add a marker in Sydney.
     */
    override fun onMapReady(googleMap: GoogleMap) {
        with(googleMap) {
            moveCamera(CameraUpdateFactory.newLatLngZoom(SYDNEY, ZOOM_LEVEL))
            addMarker(MarkerOptions().position(SYDNEY))
        }
    }
}

      

Java


public class BasicMapDemoActivity extends AppCompatActivity implements OnMapReadyCallback {

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.basic_demo);

        SupportMapFragment mapFragment =
                (SupportMapFragment) getSupportFragmentManager().findFragmentById(R.id.map);
        mapFragment.getMapAsync(this);
    }

    /**
     * This is where we can add markers or lines, add listeners or move the camera. In this case,
     * we
     * just add a marker near Africa.
     */
    @Override
    public void onMapReady(GoogleMap map) {
        map.addMarker(new MarkerOptions().position(new LatLng(0, 0)).title("Marker"));
    }
}

      

克隆并运行示例

您必须拥有 Git,才能在本地运行此示例。以下命令会克隆示例应用代码库。

git clone git@github.com:googlemaps-samples/android-samples.git

将示例项目导入到 Android Studio:

  1. 在 Android Studio 中,依次选择 File > New > Import Project
  2. 前往代码库的保存位置并选择 Kotlin 或 Java 的项目目录:

    • KotlinPATH-REPO/android-samples/ApiDemos/kotlin
    • JavaPATH-REPO/android-samples/ApiDemos/java
  3. 选择 Open。Android Studio 会使用 Gradle 构建工具来构建您的项目。
  4. 在项目的 local.properties 文件所在的同一目录中,创建一个空白 secrets.properties 文件。如需了解详情,请参阅将您的 API 密钥添加到项目中
  5. secrets.properties 中添加以下字符串,并将 YOUR_API_KEY 替换为您的 API 密钥的值:

    MAPS_API_KEY=YOUR_API_KEY
  6. 运行应用。