Выбор текущего местоположения и просмотр подробных сведений на карте

В этом руководстве рассказывается, как определить текущее местоположение устройства Android и показать сведения об организации или другом объекте, который там находится. Следуйте руководству по созданию приложения для Android с помощью Maps SDK for Android, Places SDK for Android и поставщика геоданных из нескольких источников в Location API сервисов Google Play.

Как получить код

Клонируйте или скачайте репозиторий с примерами Google Maps Android API версии 2 с сайта GitHub.

Версия на языке Java:

    // Copyright 2020 Google LLC
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
//      http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.

package com.example.currentplacedetailsonmap;

import android.content.DialogInterface;
import android.content.pm.PackageManager;
import android.location.Location;
import android.os.Bundle;

import android.util.Log;
import android.view.Menu;
import android.view.MenuItem;
import android.view.View;
import android.widget.FrameLayout;
import android.widget.TextView;

import androidx.annotation.NonNull;
import androidx.appcompat.app.AlertDialog;
import androidx.appcompat.app.AppCompatActivity;
import androidx.core.app.ActivityCompat;
import androidx.core.content.ContextCompat;

import com.google.android.gms.location.FusedLocationProviderClient;
import com.google.android.gms.location.LocationServices;
import com.google.android.gms.maps.CameraUpdateFactory;
import com.google.android.gms.maps.GoogleMap;
import com.google.android.gms.maps.OnMapReadyCallback;
import com.google.android.gms.maps.SupportMapFragment;
import com.google.android.gms.maps.model.CameraPosition;
import com.google.android.gms.maps.model.LatLng;
import com.google.android.gms.maps.model.Marker;
import com.google.android.gms.maps.model.MarkerOptions;
import com.google.android.gms.tasks.OnCompleteListener;
import com.google.android.gms.tasks.Task;

import com.google.android.libraries.places.api.Places;
import com.google.android.libraries.places.api.model.Place;
import com.google.android.libraries.places.api.model.PlaceLikelihood;
import com.google.android.libraries.places.api.net.FindCurrentPlaceRequest;
import com.google.android.libraries.places.api.net.FindCurrentPlaceResponse;
import com.google.android.libraries.places.api.net.PlacesClient;

import java.util.Arrays;
import java.util.List;

/**
 * An activity that displays a map showing the place at the device's current location.
 */
public class MapsActivityCurrentPlace extends AppCompatActivity
        implements OnMapReadyCallback {

    private static final String TAG = MapsActivityCurrentPlace.class.getSimpleName();
    private GoogleMap map;
    private CameraPosition cameraPosition;

    // The entry point to the Places API.
    private PlacesClient placesClient;

    // The entry point to the Fused Location Provider.
    private FusedLocationProviderClient fusedLocationProviderClient;

    // A default location (Sydney, Australia) and default zoom to use when location permission is
    // not granted.
    private final LatLng defaultLocation = new LatLng(-33.8523341, 151.2106085);
    private static final int DEFAULT_ZOOM = 15;
    private static final int PERMISSIONS_REQUEST_ACCESS_FINE_LOCATION = 1;
    private boolean locationPermissionGranted;

    // The geographical location where the device is currently located. That is, the last-known
    // location retrieved by the Fused Location Provider.
    private Location lastKnownLocation;

    // Keys for storing activity state.
    private static final String KEY_CAMERA_POSITION = "camera_position";
    private static final String KEY_LOCATION = "location";

    // Used for selecting the current place.
    private static final int M_MAX_ENTRIES = 5;
    private String[] likelyPlaceNames;
    private String[] likelyPlaceAddresses;
    private List[] likelyPlaceAttributions;
    private LatLng[] likelyPlaceLatLngs;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);

        // Retrieve location and camera position from saved instance state.
        if (savedInstanceState != null) {
            lastKnownLocation = savedInstanceState.getParcelable(KEY_LOCATION);
            cameraPosition = savedInstanceState.getParcelable(KEY_CAMERA_POSITION);
        }

        // Retrieve the content view that renders the map.
        setContentView(R.layout.activity_maps);

        // Construct a PlacesClient
        Places.initialize(getApplicationContext(), BuildConfig.MAPS_API_KEY);
        placesClient = Places.createClient(this);

        // Construct a FusedLocationProviderClient.
        fusedLocationProviderClient = LocationServices.getFusedLocationProviderClient(this);

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

    /**
     * Saves the state of the map when the activity is paused.
     */
    @Override
    protected void onSaveInstanceState(Bundle outState) {
        if (map != null) {
            outState.putParcelable(KEY_CAMERA_POSITION, map.getCameraPosition());
            outState.putParcelable(KEY_LOCATION, lastKnownLocation);
        }
        super.onSaveInstanceState(outState);
    }

    /**
     * Sets up the options menu.
     * @param menu The options menu.
     * @return Boolean.
     */
    @Override
    public boolean onCreateOptionsMenu(Menu menu) {
        getMenuInflater().inflate(R.menu.current_place_menu, menu);
        return true;
    }

    /**
     * Handles a click on the menu option to get a place.
     * @param item The menu item to handle.
     * @return Boolean.
     */
    @Override
    public boolean onOptionsItemSelected(MenuItem item) {
        if (item.getItemId() == R.id.option_get_place) {
            showCurrentPlace();
        }
        return true;
    }

    /**
     * Manipulates the map when it's available.
     * This callback is triggered when the map is ready to be used.
     */
    @Override
    public void onMapReady(GoogleMap map) {
        this.map = map;

        // Use a custom info window adapter to handle multiple lines of text in the
        // info window contents.
        this.map.setInfoWindowAdapter(new GoogleMap.InfoWindowAdapter() {

            @Override
            // Return null here, so that getInfoContents() is called next.
            public View getInfoWindow(Marker arg0) {
                return null;
            }

            @Override
            public View getInfoContents(Marker marker) {
                // Inflate the layouts for the info window, title and snippet.
                View infoWindow = getLayoutInflater().inflate(R.layout.custom_info_contents,
                        (FrameLayout) findViewById(R.id.map), false);

                TextView title = infoWindow.findViewById(R.id.title);
                title.setText(marker.getTitle());

                TextView snippet = infoWindow.findViewById(R.id.snippet);
                snippet.setText(marker.getSnippet());

                return infoWindow;
            }
        });

        // Prompt the user for permission.
        getLocationPermission();

        // Turn on the My Location layer and the related control on the map.
        updateLocationUI();

        // Get the current location of the device and set the position of the map.
        getDeviceLocation();
    }

    /**
     * Gets the current location of the device, and positions the map's camera.
     */
    private void getDeviceLocation() {
        /*
         * Get the best and most recent location of the device, which may be null in rare
         * cases when a location is not available.
         */
        try {
            if (locationPermissionGranted) {
                Task<Location> locationResult = fusedLocationProviderClient.getLastLocation();
                locationResult.addOnCompleteListener(this, new OnCompleteListener<Location>() {
                    @Override
                    public void onComplete(@NonNull Task<Location> task) {
                        if (task.isSuccessful()) {
                            // Set the map's camera position to the current location of the device.
                            lastKnownLocation = task.getResult();
                            if (lastKnownLocation != null) {
                                map.moveCamera(CameraUpdateFactory.newLatLngZoom(
                                        new LatLng(lastKnownLocation.getLatitude(),
                                                lastKnownLocation.getLongitude()), DEFAULT_ZOOM));
                            }
                        } else {
                            Log.d(TAG, "Current location is null. Using defaults.");
                            Log.e(TAG, "Exception: %s", task.getException());
                            map.moveCamera(CameraUpdateFactory
                                    .newLatLngZoom(defaultLocation, DEFAULT_ZOOM));
                            map.getUiSettings().setMyLocationButtonEnabled(false);
                        }
                    }
                });
            }
        } catch (SecurityException e)  {
            Log.e("Exception: %s", e.getMessage(), e);
        }
    }

    /**
     * Prompts the user for permission to use the device location.
     */
    private void getLocationPermission() {
        /*
         * Request location permission, so that we can get the location of the
         * device. The result of the permission request is handled by a callback,
         * onRequestPermissionsResult.
         */
        if (ContextCompat.checkSelfPermission(this.getApplicationContext(),
                android.Manifest.permission.ACCESS_FINE_LOCATION)
                == PackageManager.PERMISSION_GRANTED) {
            locationPermissionGranted = true;
        } else {
            ActivityCompat.requestPermissions(this,
                    new String[]{android.Manifest.permission.ACCESS_FINE_LOCATION},
                    PERMISSIONS_REQUEST_ACCESS_FINE_LOCATION);
        }
    }

    /**
     * Handles the result of the request for location permissions.
     */
    @Override
    public void onRequestPermissionsResult(int requestCode,
                                           @NonNull String[] permissions,
                                           @NonNull int[] grantResults) {
        locationPermissionGranted = false;
        switch (requestCode) {
            case PERMISSIONS_REQUEST_ACCESS_FINE_LOCATION: {
                // If request is cancelled, the result arrays are empty.
                if (grantResults.length > 0
                        && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
                    locationPermissionGranted = true;
                }
            }
        }
        updateLocationUI();
    }

    /**
     * Prompts the user to select the current place from a list of likely places, and shows the
     * current place on the map - provided the user has granted location permission.
     */
    private void showCurrentPlace() {
        if (map == null) {
            return;
        }

        if (locationPermissionGranted) {
            // Use fields to define the data types to return.
            List<Place.Field> placeFields = Arrays.asList(Place.Field.NAME, Place.Field.ADDRESS,
                    Place.Field.LAT_LNG);

            // Use the builder to create a FindCurrentPlaceRequest.
            FindCurrentPlaceRequest request =
                    FindCurrentPlaceRequest.newInstance(placeFields);

            // Get the likely places - that is, the businesses and other points of interest that
            // are the best match for the device's current location.
            @SuppressWarnings("MissingPermission") final
            Task<FindCurrentPlaceResponse> placeResult =
                    placesClient.findCurrentPlace(request);
            placeResult.addOnCompleteListener (new OnCompleteListener<FindCurrentPlaceResponse>() {
                @Override
                public void onComplete(@NonNull Task<FindCurrentPlaceResponse> task) {
                    if (task.isSuccessful() && task.getResult() != null) {
                        FindCurrentPlaceResponse likelyPlaces = task.getResult();

                        // Set the count, handling cases where less than 5 entries are returned.
                        int count;
                        if (likelyPlaces.getPlaceLikelihoods().size() < M_MAX_ENTRIES) {
                            count = likelyPlaces.getPlaceLikelihoods().size();
                        } else {
                            count = M_MAX_ENTRIES;
                        }

                        int i = 0;
                        likelyPlaceNames = new String[count];
                        likelyPlaceAddresses = new String[count];
                        likelyPlaceAttributions = new List[count];
                        likelyPlaceLatLngs = new LatLng[count];

                        for (PlaceLikelihood placeLikelihood : likelyPlaces.getPlaceLikelihoods()) {
                            // Build a list of likely places to show the user.
                            likelyPlaceNames[i] = placeLikelihood.getPlace().getName();
                            likelyPlaceAddresses[i] = placeLikelihood.getPlace().getAddress();
                            likelyPlaceAttributions[i] = placeLikelihood.getPlace()
                                    .getAttributions();
                            likelyPlaceLatLngs[i] = placeLikelihood.getPlace().getLatLng();

                            i++;
                            if (i > (count - 1)) {
                                break;
                            }
                        }

                        // Show a dialog offering the user the list of likely places, and add a
                        // marker at the selected place.
                        MapsActivityCurrentPlace.this.openPlacesDialog();
                    }
                    else {
                        Log.e(TAG, "Exception: %s", task.getException());
                    }
                }
            });
        } else {
            // The user has not granted permission.
            Log.i(TAG, "The user did not grant location permission.");

            // Add a default marker, because the user hasn't selected a place.
            map.addMarker(new MarkerOptions()
                    .title(getString(R.string.default_info_title))
                    .position(defaultLocation)
                    .snippet(getString(R.string.default_info_snippet)));

            // Prompt the user for permission.
            getLocationPermission();
        }
    }

    /**
     * Displays a form allowing the user to select a place from a list of likely places.
     */
    private void openPlacesDialog() {
        // Ask the user to choose the place where they are now.
        DialogInterface.OnClickListener listener = new DialogInterface.OnClickListener() {
            @Override
            public void onClick(DialogInterface dialog, int which) {
                // The "which" argument contains the position of the selected item.
                LatLng markerLatLng = likelyPlaceLatLngs[which];
                String markerSnippet = likelyPlaceAddresses[which];
                if (likelyPlaceAttributions[which] != null) {
                    markerSnippet = markerSnippet + "\n" + likelyPlaceAttributions[which];
                }

                // Add a marker for the selected place, with an info window
                // showing information about that place.
                map.addMarker(new MarkerOptions()
                        .title(likelyPlaceNames[which])
                        .position(markerLatLng)
                        .snippet(markerSnippet));

                // Position the map's camera at the location of the marker.
                map.moveCamera(CameraUpdateFactory.newLatLngZoom(markerLatLng,
                        DEFAULT_ZOOM));
            }
        };

        // Display the dialog.
        AlertDialog dialog = new AlertDialog.Builder(this)
                .setTitle(R.string.pick_place)
                .setItems(likelyPlaceNames, listener)
                .show();
    }

    /**
     * Updates the map's UI settings based on whether the user has granted location permission.
     */
    private void updateLocationUI() {
        if (map == null) {
            return;
        }
        try {
            if (locationPermissionGranted) {
                map.setMyLocationEnabled(true);
                map.getUiSettings().setMyLocationButtonEnabled(true);
            } else {
                map.setMyLocationEnabled(false);
                map.getUiSettings().setMyLocationButtonEnabled(false);
                lastKnownLocation = null;
                getLocationPermission();
            }
        } catch (SecurityException e)  {
            Log.e("Exception: %s", e.getMessage());
        }
    }
}

    

Версия на языке Kotlin:

    // Copyright 2020 Google LLC
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
//      http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.
package com.example.currentplacedetailsonmap

import android.Manifest
import android.annotation.SuppressLint
import android.content.DialogInterface
import android.content.pm.PackageManager
import android.location.Location
import android.os.Bundle
import android.util.Log
import android.view.Menu
import android.view.MenuItem
import android.view.View
import android.widget.FrameLayout
import android.widget.TextView
import androidx.appcompat.app.AlertDialog
import androidx.appcompat.app.AppCompatActivity
import androidx.core.app.ActivityCompat
import androidx.core.content.ContextCompat
import com.google.android.gms.location.FusedLocationProviderClient
import com.google.android.gms.location.LocationServices
import com.google.android.gms.maps.CameraUpdateFactory
import com.google.android.gms.maps.GoogleMap
import com.google.android.gms.maps.GoogleMap.InfoWindowAdapter
import com.google.android.gms.maps.OnMapReadyCallback
import com.google.android.gms.maps.SupportMapFragment
import com.google.android.gms.maps.model.CameraPosition
import com.google.android.gms.maps.model.LatLng
import com.google.android.gms.maps.model.Marker
import com.google.android.gms.maps.model.MarkerOptions
import com.google.android.libraries.places.api.Places
import com.google.android.libraries.places.api.model.Place
import com.google.android.libraries.places.api.net.FindCurrentPlaceRequest
import com.google.android.libraries.places.api.net.PlacesClient

/**
 * An activity that displays a map showing the place at the device's current location.
 */
class MapsActivityCurrentPlace : AppCompatActivity(), OnMapReadyCallback {
    private var map: GoogleMap? = null
    private var cameraPosition: CameraPosition? = null

    // The entry point to the Places API.
    private lateinit var placesClient: PlacesClient

    // The entry point to the Fused Location Provider.
    private lateinit var fusedLocationProviderClient: FusedLocationProviderClient

    // A default location (Sydney, Australia) and default zoom to use when location permission is
    // not granted.
    private val defaultLocation = LatLng(-33.8523341, 151.2106085)
    private var locationPermissionGranted = false

    // The geographical location where the device is currently located. That is, the last-known
    // location retrieved by the Fused Location Provider.
    private var lastKnownLocation: Location? = null
    private var likelyPlaceNames: Array<String?> = arrayOfNulls(0)
    private var likelyPlaceAddresses: Array<String?> = arrayOfNulls(0)
    private var likelyPlaceAttributions: Array<List<*>?> = arrayOfNulls(0)
    private var likelyPlaceLatLngs: Array<LatLng?> = arrayOfNulls(0)

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)

        // Retrieve location and camera position from saved instance state.
        if (savedInstanceState != null) {
            lastKnownLocation = savedInstanceState.getParcelable(KEY_LOCATION)
            cameraPosition = savedInstanceState.getParcelable(KEY_CAMERA_POSITION)
        }

        // Retrieve the content view that renders the map.
        setContentView(R.layout.activity_maps)

        // Construct a PlacesClient
        Places.initialize(applicationContext, BuildConfig.MAPS_API_KEY)
        placesClient = Places.createClient(this)

        // Construct a FusedLocationProviderClient.
        fusedLocationProviderClient = LocationServices.getFusedLocationProviderClient(this)

        // Build the map.
        val mapFragment = supportFragmentManager
            .findFragmentById(R.id.map) as SupportMapFragment?
        mapFragment?.getMapAsync(this)
    }

    /**
     * Saves the state of the map when the activity is paused.
     */
    override fun onSaveInstanceState(outState: Bundle) {
        map?.let { map ->
            outState.putParcelable(KEY_CAMERA_POSITION, map.cameraPosition)
            outState.putParcelable(KEY_LOCATION, lastKnownLocation)
        }
        super.onSaveInstanceState(outState)
    }

    /**
     * Sets up the options menu.
     * @param menu The options menu.
     * @return Boolean.
     */
    override fun onCreateOptionsMenu(menu: Menu): Boolean {
        menuInflater.inflate(R.menu.current_place_menu, menu)
        return true
    }

    /**
     * Handles a click on the menu option to get a place.
     * @param item The menu item to handle.
     * @return Boolean.
     */
    override fun onOptionsItemSelected(item: MenuItem): Boolean {
        if (item.itemId == R.id.option_get_place) {
            showCurrentPlace()
        }
        return true
    }

    /**
     * Manipulates the map when it's available.
     * This callback is triggered when the map is ready to be used.
     */
    override fun onMapReady(map: GoogleMap) {
        this.map = map

        // Use a custom info window adapter to handle multiple lines of text in the
        // info window contents.
        this.map?.setInfoWindowAdapter(object : InfoWindowAdapter {
            // Return null here, so that getInfoContents() is called next.
            override fun getInfoWindow(arg0: Marker): View? {
                return null
            }

            override fun getInfoContents(marker: Marker): View {
                // Inflate the layouts for the info window, title and snippet.
                val infoWindow = layoutInflater.inflate(R.layout.custom_info_contents,
                    findViewById<FrameLayout>(R.id.map), false)
                val title = infoWindow.findViewById<TextView>(R.id.title)
                title.text = marker.title
                val snippet = infoWindow.findViewById<TextView>(R.id.snippet)
                snippet.text = marker.snippet
                return infoWindow
            }
        })

        // Prompt the user for permission.
        getLocationPermission()

        // Turn on the My Location layer and the related control on the map.
        updateLocationUI()

        // Get the current location of the device and set the position of the map.
        getDeviceLocation()
    }

    /**
     * Gets the current location of the device, and positions the map's camera.
     */
    private fun getDeviceLocation() {
        /*
         * Get the best and most recent location of the device, which may be null in rare
         * cases when a location is not available.
         */
        try {
            if (locationPermissionGranted) {
                val locationResult = fusedLocationProviderClient.lastLocation
                locationResult.addOnCompleteListener(this) { task ->
                    if (task.isSuccessful) {
                        // Set the map's camera position to the current location of the device.
                        lastKnownLocation = task.result
                        if (lastKnownLocation != null) {
                            map?.moveCamera(CameraUpdateFactory.newLatLngZoom(
                                LatLng(lastKnownLocation!!.latitude,
                                    lastKnownLocation!!.longitude), DEFAULT_ZOOM.toFloat()))
                        }
                    } else {
                        Log.d(TAG, "Current location is null. Using defaults.")
                        Log.e(TAG, "Exception: %s", task.exception)
                        map?.moveCamera(CameraUpdateFactory
                            .newLatLngZoom(defaultLocation, DEFAULT_ZOOM.toFloat()))
                        map?.uiSettings?.isMyLocationButtonEnabled = false
                    }
                }
            }
        } catch (e: SecurityException) {
            Log.e("Exception: %s", e.message, e)
        }
    }

    /**
     * Prompts the user for permission to use the device location.
     */
    private fun getLocationPermission() {
        /*
         * Request location permission, so that we can get the location of the
         * device. The result of the permission request is handled by a callback,
         * onRequestPermissionsResult.
         */
        if (ContextCompat.checkSelfPermission(this.applicationContext,
                Manifest.permission.ACCESS_FINE_LOCATION)
            == PackageManager.PERMISSION_GRANTED) {
            locationPermissionGranted = true
        } else {
            ActivityCompat.requestPermissions(this, arrayOf(Manifest.permission.ACCESS_FINE_LOCATION),
                PERMISSIONS_REQUEST_ACCESS_FINE_LOCATION)
        }
    }

    /**
     * Handles the result of the request for location permissions.
     */
    override fun onRequestPermissionsResult(requestCode: Int,
                                            permissions: Array<String>,
                                            grantResults: IntArray) {
        locationPermissionGranted = false
        when (requestCode) {
            PERMISSIONS_REQUEST_ACCESS_FINE_LOCATION -> {

                // If request is cancelled, the result arrays are empty.
                if (grantResults.isNotEmpty() &&
                    grantResults[0] == PackageManager.PERMISSION_GRANTED) {
                    locationPermissionGranted = true
                }
            }
        }
        updateLocationUI()
    }

    /**
     * Prompts the user to select the current place from a list of likely places, and shows the
     * current place on the map - provided the user has granted location permission.
     */
    @SuppressLint("MissingPermission")
    private fun showCurrentPlace() {
        if (map == null) {
            return
        }
        if (locationPermissionGranted) {
            // Use fields to define the data types to return.
            val placeFields = listOf(Place.Field.NAME, Place.Field.ADDRESS, Place.Field.LAT_LNG)

            // Use the builder to create a FindCurrentPlaceRequest.
            val request = FindCurrentPlaceRequest.newInstance(placeFields)

            // Get the likely places - that is, the businesses and other points of interest that
            // are the best match for the device's current location.
            val placeResult = placesClient.findCurrentPlace(request)
            placeResult.addOnCompleteListener { task ->
                if (task.isSuccessful && task.result != null) {
                    val likelyPlaces = task.result

                    // Set the count, handling cases where less than 5 entries are returned.
                    val count = if (likelyPlaces != null && likelyPlaces.placeLikelihoods.size < M_MAX_ENTRIES) {
                        likelyPlaces.placeLikelihoods.size
                    } else {
                        M_MAX_ENTRIES
                    }
                    var i = 0
                    likelyPlaceNames = arrayOfNulls(count)
                    likelyPlaceAddresses = arrayOfNulls(count)
                    likelyPlaceAttributions = arrayOfNulls<List<*>?>(count)
                    likelyPlaceLatLngs = arrayOfNulls(count)
                    for (placeLikelihood in likelyPlaces?.placeLikelihoods ?: emptyList()) {
                        // Build a list of likely places to show the user.
                        likelyPlaceNames[i] = placeLikelihood.place.name
                        likelyPlaceAddresses[i] = placeLikelihood.place.address
                        likelyPlaceAttributions[i] = placeLikelihood.place.attributions
                        likelyPlaceLatLngs[i] = placeLikelihood.place.latLng
                        i++
                        if (i > count - 1) {
                            break
                        }
                    }

                    // Show a dialog offering the user the list of likely places, and add a
                    // marker at the selected place.
                    openPlacesDialog()
                } else {
                    Log.e(TAG, "Exception: %s", task.exception)
                }
            }
        } else {
            // The user has not granted permission.
            Log.i(TAG, "The user did not grant location permission.")

            // Add a default marker, because the user hasn't selected a place.
            map?.addMarker(MarkerOptions()
                .title(getString(R.string.default_info_title))
                .position(defaultLocation)
                .snippet(getString(R.string.default_info_snippet)))

            // Prompt the user for permission.
            getLocationPermission()
        }
    }

    /**
     * Displays a form allowing the user to select a place from a list of likely places.
     */
    private fun openPlacesDialog() {
        // Ask the user to choose the place where they are now.
        val listener = DialogInterface.OnClickListener { dialog, which -> // The "which" argument contains the position of the selected item.
            val markerLatLng = likelyPlaceLatLngs[which]
            var markerSnippet = likelyPlaceAddresses[which]
            if (likelyPlaceAttributions[which] != null) {
                markerSnippet = """
                    $markerSnippet
                    ${likelyPlaceAttributions[which]}
                    """.trimIndent()
            }

            // Add a marker for the selected place, with an info window
            // showing information about that place.
            map?.addMarker(MarkerOptions()
                .title(likelyPlaceNames[which])
                .position(markerLatLng!!)
                .snippet(markerSnippet))

            // Position the map's camera at the location of the marker.
            map?.moveCamera(CameraUpdateFactory.newLatLngZoom(markerLatLng,
                DEFAULT_ZOOM.toFloat()))
        }

        // Display the dialog.
        AlertDialog.Builder(this)
            .setTitle(R.string.pick_place)
            .setItems(likelyPlaceNames, listener)
            .show()
    }

    /**
     * Updates the map's UI settings based on whether the user has granted location permission.
     */
    private fun updateLocationUI() {
        if (map == null) {
            return
        }
        try {
            if (locationPermissionGranted) {
                map?.isMyLocationEnabled = true
                map?.uiSettings?.isMyLocationButtonEnabled = true
            } else {
                map?.isMyLocationEnabled = false
                map?.uiSettings?.isMyLocationButtonEnabled = false
                lastKnownLocation = null
                getLocationPermission()
            }
        } catch (e: SecurityException) {
            Log.e("Exception: %s", e.message, e)
        }
    }

    companion object {
        private val TAG = MapsActivityCurrentPlace::class.java.simpleName
        private const val DEFAULT_ZOOM = 15
        private const val PERMISSIONS_REQUEST_ACCESS_FINE_LOCATION = 1

        // Keys for storing activity state.
        private const val KEY_CAMERA_POSITION = "camera_position"
        private const val KEY_LOCATION = "location"

        // Used for selecting the current place.
        private const val M_MAX_ENTRIES = 5
    }
}

    

Как настроить проект

Чтобы создать проект в Android Studio, выполните следующие действия:

  1. Скачайте и установите Android Studio.
  2. Добавьте пакет сервисов Google Play в Android Studio.
  3. Клонируйте или скачайте репозиторий с примерами Google Maps Android API версии 2 с сайта GitHub, если вы ещё не сделали этого.
  4. Импортируйте обучающий проект:

    • В Android Studio выберите Файл > Создать > Импортировать проект.
    • Перейдите в каталог, где вы сохранили репозиторий с примерами Google Maps Android API версии 2 после его скачивания.
    • Найдите проект CurrentPlaceDetailsOnMap. Он расположен в следующем каталоге:
      PATH-TO-SAVED-REPO/android-samples/tutorials/java/CurrentPlaceDetailsOnMap (Java)
      PATH-TO-SAVED-REPO/android-samples/tutorials/kotlin/CurrentPlaceDetailsOnMap (Kotlin)
    • Выберите каталог проекта и нажмите ОК. Теперь Android Studio создаст ваш проект с использованием инструмента сборки Gradle.

Как получить ключ API и активировать нужные API

Для выполнения этого учебного проекта вам понадобится ключ Google API, который авторизован для работы с Maps SDK for Android и Places SDK for Android.

Нажмите кнопку ниже, чтобы получить ключ и активировать API.

Начать

Более подробную информацию можно найти в полном руководстве по получению ключа API.

Как добавить ключ API в свое приложение

  1. Откройте файл local.properties проекта.
  2. Добавьте приведенную ниже строку и укажите вместо YOUR_API_KEY ваш ключ API.

    MAPS_API_KEY=YOUR_API_KEY

    Плагин Secrets Gradle Plugin для Android копирует ключ API во время сборки приложения и делает его доступным в виде переменной сборки в манифесте Android.

    Как создать сборку и запустить приложение

    1. Подключите устройство Android к компьютеру. Выполните инструкции по активации параметров для разработчиков на устройстве Android и настройте ваше приложение и систему для обнаружения этого устройства. Для настройки виртуального устройства вы также можете использовать Менеджер виртуального устройства Android (AVD). Выбирая эмулятор, убедитесь, что вы используете образ, который содержит интерфейсы Google API. Подробную информацию можно найти в руководстве по началу работы.
    2. В Android Studio выберите пункт меню Запустить или нажмите на значок воспроизведения, чтобы запустить свое приложение. В открывшемся окне выберите устройство.

    Android Studio запустит Gradle для сборки приложения, а затем отобразит результаты на устройстве или в эмуляторе. Вы должны увидеть карту с набором маркеров, в центре которой будет ваше актуальное местоположение, как показано на иллюстрации на этой странице.

    Устранение неполадок

    • Если карта не отображается, проверьте, получен ли ключ API и добавлен ли он в приложение как описано выше. Проверьте журнал Android Monitor в Android Studio на наличие сообщений об ошибках, касающихся ключа API.
    • Если на карте отображается только один маркер, установленный на Сиднейском мосту (местоположение по умолчанию, указанное в приложении), проверьте, предоставили ли вы приложению доступ к данным о местоположении. Приложение запрашивает доступ в процессе запуска, используя шаблон, который приводится в руководстве с описанием разрешений Android. Обратите внимание, что разрешения можно также предоставить непосредственно на устройстве, выбрав Настройки > Приложения > название приложения > Разрешения > Местоположение. Подробную информацию о том, как указывать разрешения в коде, вы найдете ниже, в руководстве по запросу доступа к данным о местоположении.
    • Используйте средства отладки Android Studio чтобы просмотреть журналы и выполнить отладку приложения.

    Понимание кода

    В этой части руководства описаны наиболее важные компоненты приложения CurrentPlaceDetailsOnMap, чтобы вы могли понять принципы создания подобного приложения.

    Создание клиента Places API

    Ниже указаны объекты, которые являются основными точками входа в Places SDK на платформе Android:

    • Класс Places создает клиентов для Places SDK на платформе Android и управляет ими.
    • Интерфейс PlaceDetectionClient устанавливает текущее местоположение устройства и мест рядом.

    Интерфейс LocationServices – главная точка входа для сервисов геолокации на платформе Android.

    Чтобы использовать API, выполните следующие действия в рамках метода onCreate() вашего фрагмента или действия:

    1. Инициализируйте объект Places.
    2. Создайте объект PlaceDetectionClient.
    3. Создайте объект FusedLocationProviderClient.

    Пример:

    Java

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
    
        // ...
    
        // Retrieve the content view that renders the map.
        setContentView(R.layout.activity_maps);
    
        // Construct a PlacesClient
        Places.initialize(getApplicationContext(), getString(R.string.maps_api_key));
        placesClient = Places.createClient(this);
    
        // Construct a FusedLocationProviderClient.
        fusedLocationProviderClient = LocationServices.getFusedLocationProviderClient(this);
    }
    

    Kotlin

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
    
        // ...
    
        // Retrieve the content view that renders the map.
        setContentView(R.layout.activity_maps)
    
        // Construct a PlacesClient
        Places.initialize(applicationContext, getString(R.string.maps_api_key))
        placesClient = Places.createClient(this)
    
        // Construct a FusedLocationProviderClient.
        fusedLocationProviderClient = LocationServices.getFusedLocationProviderClient(this)
    
    }
    

    Запрос доступа к данным о местоположении

    Чтобы в вашем приложении работали функции геолокации (в том числе кнопка Мое местоположение на карте), необходимо получить от пользователя разрешение на доступ к данным о местоположении.

    Это руководство содержит код, позволяющий запросить доступ к точным данным о местоположении. Подробную информацию можно найти в руководстве по разрешениям Android.

    1. Добавьте следующее разрешение в качестве дочернего для элемента <manifest> в вашем манифесте Android:

      <manifest xmlns:android="http://schemas.android.com/apk/res/android"
          package="com.example.currentplacedetailsonmap">
          <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
      </manifest>
      
    2. Запросите разрешения при запуске приложения, чтобы пользователь мог принять или отклонить запрос доступа к данным о местоположении. Следующий код позволяет проверить, предоставил ли пользователь доступ к данным о точном местоположении. Если разрешение отсутствует, оно будет запрошено у пользователя.

      Java

      private void getLocationPermission() {
          /*
           * Request location permission, so that we can get the location of the
           * device. The result of the permission request is handled by a callback,
           * onRequestPermissionsResult.
           */
          if (ContextCompat.checkSelfPermission(this.getApplicationContext(),
                  android.Manifest.permission.ACCESS_FINE_LOCATION)
                  == PackageManager.PERMISSION_GRANTED) {
              locationPermissionGranted = true;
          } else {
              ActivityCompat.requestPermissions(this,
                      new String[]{android.Manifest.permission.ACCESS_FINE_LOCATION},
                      PERMISSIONS_REQUEST_ACCESS_FINE_LOCATION);
          }
      }
      

      Kotlin

      private fun getLocationPermission() {
          /*
           * Request location permission, so that we can get the location of the
           * device. The result of the permission request is handled by a callback,
           * onRequestPermissionsResult.
           */
          if (ContextCompat.checkSelfPermission(this.applicationContext,
                  Manifest.permission.ACCESS_FINE_LOCATION)
              == PackageManager.PERMISSION_GRANTED) {
              locationPermissionGranted = true
          } else {
              ActivityCompat.requestPermissions(this, arrayOf(Manifest.permission.ACCESS_FINE_LOCATION),
                  PERMISSIONS_REQUEST_ACCESS_FINE_LOCATION)
          }
      }
      
    3. Переопределите обратный вызов метода onRequestPermissionsResult(), чтобы обработать результат запроса доступа:

      Java

      @Override
      public void onRequestPermissionsResult(int requestCode,
                                             @NonNull String[] permissions,
                                             @NonNull int[] grantResults) {
          locationPermissionGranted = false;
          switch (requestCode) {
              case PERMISSIONS_REQUEST_ACCESS_FINE_LOCATION: {
                  // If request is cancelled, the result arrays are empty.
                  if (grantResults.length > 0
                          && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
                      locationPermissionGranted = true;
                  }
              }
          }
          updateLocationUI();
      }
      

      Kotlin

      override fun onRequestPermissionsResult(requestCode: Int,
                                              permissions: Array<String>,
                                              grantResults: IntArray) {
          locationPermissionGranted = false
          when (requestCode) {
              PERMISSIONS_REQUEST_ACCESS_FINE_LOCATION -> {
      
                  // If request is cancelled, the result arrays are empty.
                  if (grantResults.isNotEmpty() &&
                      grantResults[0] == PackageManager.PERMISSION_GRANTED) {
                      locationPermissionGranted = true
                  }
              }
          }
          updateLocationUI()
      }
      

      Метод updateLocationUI() мы рассмотрим ниже.

    Добавление карты

    Отобразите карту, используя Maps SDK для Android.

    1. Добавьте элемент <fragment> в файл макета для объекта activity, activity_maps.xml. Этот элемент указывает, что фрагмент SupportMapFragment должен выступать в роли контейнера для карты и предоставить доступ к объекту GoogleMap. В учебном проекте используется версия вспомогательной библиотеки Android для фрагмента карты, чтобы обеспечить обратную совместимость с более ранними версиями фреймворка Android.

      <!--
       Copyright 2020 Google LLC
      
       Licensed under the Apache License, Version 2.0 (the "License");
       you may not use this file except in compliance with the License.
       You may obtain a copy of the License at
      
            http://www.apache.org/licenses/LICENSE-2.0
      
       Unless required by applicable law or agreed to in writing, software
       distributed under the License is distributed on an "AS IS" BASIS,
       WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
       See the License for the specific language governing permissions and
       limitations under the License.
      -->
      
      <fragment xmlns:android="http://schemas.android.com/apk/res/android"
          xmlns:tools="http://schemas.android.com/tools"
          android:id="@+id/map"
          android:name="com.google.android.gms.maps.SupportMapFragment"
          android:layout_width="match_parent"
          android:layout_height="match_parent"
          tools:context="com.example.currentplacedetailsonmap.MapsActivityCurrentPlace" />
      
      
    2. В методе onCreate() своего объекта activity установите файл макета как представление контента.

      Java

      @Override
      protected void onCreate(Bundle savedInstanceState) {
          super.onCreate(savedInstanceState);
      
          // Retrieve the content view that renders the map.
          setContentView(R.layout.activity_maps);
      
      }
      

      Kotlin

      override fun onCreate(savedInstanceState: Bundle?) {
          super.onCreate(savedInstanceState)
      
          // Retrieve the content view that renders the map.
          setContentView(R.layout.activity_maps)
      
      }
      
    3. Реализуйте интерфейс OnMapReadyCallback и переопределите метод onMapReady(), чтобы настроить карту, когда объект GoogleMap будет доступен:

      Java

      @Override
      public void onMapReady(GoogleMap map) {
          this.map = map;
      
          // ...
      
          // Turn on the My Location layer and the related control on the map.
          updateLocationUI();
      
          // Get the current location of the device and set the position of the map.
          getDeviceLocation();
      }
      

      Kotlin

      override fun onMapReady(map: GoogleMap) {
          this.map = map
      
          // ...
      
          // Turn on the My Location layer and the related control on the map.
          updateLocationUI()
      
          // Get the current location of the device and set the position of the map.
          getDeviceLocation()
      }
      
    4. В методе onCreate() своего объекта activity получите дескриптор для фрагмента карты путем вызова метода FragmentManager.findFragmentById(). Затем используйте метод getMapAsync(), чтобы зарегистрировать обратный вызов карты:

      Java

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

      Kotlin

      val mapFragment = supportFragmentManager
          .findFragmentById(R.id.map) as SupportMapFragment?
      mapFragment?.getMapAsync(this)
      
    5. Разместите в коде метод updateLocationUI(), чтобы добавить на карту элементы управления. Если пользователь предоставил разрешение на использование данных о местоположении, активируйте слой "Мое местоположение" и соответствующий элемент управления на карте. В противном случае отключите их и установите для текущего местоположения значение null:

      Java

      private void updateLocationUI() {
          if (map == null) {
              return;
          }
          try {
              if (locationPermissionGranted) {
                  map.setMyLocationEnabled(true);
                  map.getUiSettings().setMyLocationButtonEnabled(true);
              } else {
                  map.setMyLocationEnabled(false);
                  map.getUiSettings().setMyLocationButtonEnabled(false);
                  lastKnownLocation = null;
                  getLocationPermission();
              }
          } catch (SecurityException e)  {
              Log.e("Exception: %s", e.getMessage());
          }
      }
      

      Kotlin

      private fun updateLocationUI() {
          if (map == null) {
              return
          }
          try {
              if (locationPermissionGranted) {
                  map?.isMyLocationEnabled = true
                  map?.uiSettings?.isMyLocationButtonEnabled = true
              } else {
                  map?.isMyLocationEnabled = false
                  map?.uiSettings?.isMyLocationButtonEnabled = false
                  lastKnownLocation = null
                  getLocationPermission()
              }
          } catch (e: SecurityException) {
              Log.e("Exception: %s", e.message, e)
          }
      }
      

    Как получить информацию о местоположении устройства Android и позиции карты

    Обратитесь к поставщику геоданных из нескольких источников, чтобы определить последнее известное местоположение устройства. Затем используйте эти данные для позиционирования карты. В этом руководстве есть код, который вам понадобится. Дополнительную информацию о том, как определить местоположение устройства, можно найти в руководстве по работе с поставщиком геоданных из нескольких источников для Location API сервисов Google Play.

    Java

    private void getDeviceLocation() {
        /*
         * Get the best and most recent location of the device, which may be null in rare
         * cases when a location is not available.
         */
        try {
            if (locationPermissionGranted) {
                Task<Location> locationResult = fusedLocationProviderClient.getLastLocation();
                locationResult.addOnCompleteListener(this, new OnCompleteListener<Location>() {
                    @Override
                    public void onComplete(@NonNull Task<Location> task) {
                        if (task.isSuccessful()) {
                            // Set the map's camera position to the current location of the device.
                            lastKnownLocation = task.getResult();
                            if (lastKnownLocation != null) {
                                map.moveCamera(CameraUpdateFactory.newLatLngZoom(
                                        new LatLng(lastKnownLocation.getLatitude(),
                                                lastKnownLocation.getLongitude()), DEFAULT_ZOOM));
                            }
                        } else {
                            Log.d(TAG, "Current location is null. Using defaults.");
                            Log.e(TAG, "Exception: %s", task.getException());
                            map.moveCamera(CameraUpdateFactory
                                    .newLatLngZoom(defaultLocation, DEFAULT_ZOOM));
                            map.getUiSettings().setMyLocationButtonEnabled(false);
                        }
                    }
                });
            }
        } catch (SecurityException e)  {
            Log.e("Exception: %s", e.getMessage(), e);
        }
    }
    

    Kotlin

    private fun getDeviceLocation() {
        /*
         * Get the best and most recent location of the device, which may be null in rare
         * cases when a location is not available.
         */
        try {
            if (locationPermissionGranted) {
                val locationResult = fusedLocationProviderClient.lastLocation
                locationResult.addOnCompleteListener(this) { task ->
                    if (task.isSuccessful) {
                        // Set the map's camera position to the current location of the device.
                        lastKnownLocation = task.result
                        if (lastKnownLocation != null) {
                            map?.moveCamera(CameraUpdateFactory.newLatLngZoom(
                                LatLng(lastKnownLocation!!.latitude,
                                    lastKnownLocation!!.longitude), DEFAULT_ZOOM.toFloat()))
                        }
                    } else {
                        Log.d(TAG, "Current location is null. Using defaults.")
                        Log.e(TAG, "Exception: %s", task.exception)
                        map?.moveCamera(CameraUpdateFactory
                            .newLatLngZoom(defaultLocation, DEFAULT_ZOOM.toFloat()))
                        map?.uiSettings?.isMyLocationButtonEnabled = false
                    }
                }
            }
        } catch (e: SecurityException) {
            Log.e("Exception: %s", e.message, e)
        }
    }
    

    Как получить данные о текущем местоположении

    Получить список мест, где с вероятностью может находиться устройство, можно с помощью Places SDK for Android. Место в данном случае – это компания или другой объект для посещения.

    Выполните приведенные ниже инструкции, чтобы настроить показ места, когда пользователь нажимает кнопку Узнать место. Пользователь увидит список подходящих мест и сможет сделать выбор, а затем добавить на карту маркер, чтобы указать местоположение выбранного места. В этом руководстве вы найдете код для взаимодействия с Places SDK for Android. Дополнительную информацию можно найти в руководстве по получению информации о текущем месте.

    1. Создайте файл макета (current_place_menu.xml) для меню параметров и переопределите метод onCreateOptionsMenu(), чтобы настроить это меню. Ознакомьтесь с кодом в примере приложения.
    2. Переопределите метод onOptionsItemSelected(), чтобы получать актуальную информацию о месте, когда пользователь нажимает Узнать место:

      Java

      @Override
      public boolean onOptionsItemSelected(MenuItem item) {
          if (item.getItemId() == R.id.option_get_place) {
              showCurrentPlace();
          }
          return true;
      }
      

      Kotlin

      override fun onOptionsItemSelected(item: MenuItem): Boolean {
          if (item.itemId == R.id.option_get_place) {
              showCurrentPlace()
          }
          return true
      }
      
    3. Создайте метод showCurrentPlace(), чтобы получить список мест, где может находиться устройство:

      Java

      private void showCurrentPlace() {
          if (map == null) {
              return;
          }
      
          if (locationPermissionGranted) {
              // Use fields to define the data types to return.
              List<Place.Field> placeFields = Arrays.asList(Place.Field.NAME, Place.Field.ADDRESS,
                      Place.Field.LAT_LNG);
      
              // Use the builder to create a FindCurrentPlaceRequest.
              FindCurrentPlaceRequest request =
                      FindCurrentPlaceRequest.newInstance(placeFields);
      
              // Get the likely places - that is, the businesses and other points of interest that
              // are the best match for the device's current location.
              @SuppressWarnings("MissingPermission") final
              Task<FindCurrentPlaceResponse> placeResult =
                      placesClient.findCurrentPlace(request);
              placeResult.addOnCompleteListener (new OnCompleteListener<FindCurrentPlaceResponse>() {
                  @Override
                  public void onComplete(@NonNull Task<FindCurrentPlaceResponse> task) {
                      if (task.isSuccessful() && task.getResult() != null) {
                          FindCurrentPlaceResponse likelyPlaces = task.getResult();
      
                          // Set the count, handling cases where less than 5 entries are returned.
                          int count;
                          if (likelyPlaces.getPlaceLikelihoods().size() < M_MAX_ENTRIES) {
                              count = likelyPlaces.getPlaceLikelihoods().size();
                          } else {
                              count = M_MAX_ENTRIES;
                          }
      
                          int i = 0;
                          likelyPlaceNames = new String[count];
                          likelyPlaceAddresses = new String[count];
                          likelyPlaceAttributions = new List[count];
                          likelyPlaceLatLngs = new LatLng[count];
      
                          for (PlaceLikelihood placeLikelihood : likelyPlaces.getPlaceLikelihoods()) {
                              // Build a list of likely places to show the user.
                              likelyPlaceNames[i] = placeLikelihood.getPlace().getName();
                              likelyPlaceAddresses[i] = placeLikelihood.getPlace().getAddress();
                              likelyPlaceAttributions[i] = placeLikelihood.getPlace()
                                      .getAttributions();
                              likelyPlaceLatLngs[i] = placeLikelihood.getPlace().getLatLng();
      
                              i++;
                              if (i > (count - 1)) {
                                  break;
                              }
                          }
      
                          // Show a dialog offering the user the list of likely places, and add a
                          // marker at the selected place.
                          MapsActivityCurrentPlace.this.openPlacesDialog();
                      }
                      else {
                          Log.e(TAG, "Exception: %s", task.getException());
                      }
                  }
              });
          } else {
              // The user has not granted permission.
              Log.i(TAG, "The user did not grant location permission.");
      
              // Add a default marker, because the user hasn't selected a place.
              map.addMarker(new MarkerOptions()
                      .title(getString(R.string.default_info_title))
                      .position(defaultLocation)
                      .snippet(getString(R.string.default_info_snippet)));
      
              // Prompt the user for permission.
              getLocationPermission();
          }
      }
      

      Kotlin

      @SuppressLint("MissingPermission")
      private fun showCurrentPlace() {
          if (map == null) {
              return
          }
          if (locationPermissionGranted) {
              // Use fields to define the data types to return.
              val placeFields = listOf(Place.Field.NAME, Place.Field.ADDRESS, Place.Field.LAT_LNG)
      
              // Use the builder to create a FindCurrentPlaceRequest.
              val request = FindCurrentPlaceRequest.newInstance(placeFields)
      
              // Get the likely places - that is, the businesses and other points of interest that
              // are the best match for the device's current location.
              val placeResult = placesClient.findCurrentPlace(request)
              placeResult.addOnCompleteListener { task ->
                  if (task.isSuccessful && task.result != null) {
                      val likelyPlaces = task.result
      
                      // Set the count, handling cases where less than 5 entries are returned.
                      val count = if (likelyPlaces != null && likelyPlaces.placeLikelihoods.size < M_MAX_ENTRIES) {
                          likelyPlaces.placeLikelihoods.size
                      } else {
                          M_MAX_ENTRIES
                      }
                      var i = 0
                      likelyPlaceNames = arrayOfNulls(count)
                      likelyPlaceAddresses = arrayOfNulls(count)
                      likelyPlaceAttributions = arrayOfNulls<List<*>?>(count)
                      likelyPlaceLatLngs = arrayOfNulls(count)
                      for (placeLikelihood in likelyPlaces?.placeLikelihoods ?: emptyList()) {
                          // Build a list of likely places to show the user.
                          likelyPlaceNames[i] = placeLikelihood.place.name
                          likelyPlaceAddresses[i] = placeLikelihood.place.address
                          likelyPlaceAttributions[i] = placeLikelihood.place.attributions
                          likelyPlaceLatLngs[i] = placeLikelihood.place.latLng
                          i++
                          if (i > count - 1) {
                              break
                          }
                      }
      
                      // Show a dialog offering the user the list of likely places, and add a
                      // marker at the selected place.
                      openPlacesDialog()
                  } else {
                      Log.e(TAG, "Exception: %s", task.exception)
                  }
              }
          } else {
              // The user has not granted permission.
              Log.i(TAG, "The user did not grant location permission.")
      
              // Add a default marker, because the user hasn't selected a place.
              map?.addMarker(MarkerOptions()
                  .title(getString(R.string.default_info_title))
                  .position(defaultLocation)
                  .snippet(getString(R.string.default_info_snippet)))
      
              // Prompt the user for permission.
              getLocationPermission()
          }
      }
      
    4. Создайте метод openPlacesDialog(), чтобы показать форму, в которой пользователь может выбрать место из списка. Добавьте на карту маркер для выбранного места. Маркер должен содержать сведения о названии и адресе места, а также другие атрибуты, которые предоставляет API:

      Java

      private void openPlacesDialog() {
          // Ask the user to choose the place where they are now.
          DialogInterface.OnClickListener listener = new DialogInterface.OnClickListener() {
              @Override
              public void onClick(DialogInterface dialog, int which) {
                  // The "which" argument contains the position of the selected item.
                  LatLng markerLatLng = likelyPlaceLatLngs[which];
                  String markerSnippet = likelyPlaceAddresses[which];
                  if (likelyPlaceAttributions[which] != null) {
                      markerSnippet = markerSnippet + "\n" + likelyPlaceAttributions[which];
                  }
      
                  // Add a marker for the selected place, with an info window
                  // showing information about that place.
                  map.addMarker(new MarkerOptions()
                          .title(likelyPlaceNames[which])
                          .position(markerLatLng)
                          .snippet(markerSnippet));
      
                  // Position the map's camera at the location of the marker.
                  map.moveCamera(CameraUpdateFactory.newLatLngZoom(markerLatLng,
                          DEFAULT_ZOOM));
              }
          };
      
          // Display the dialog.
          AlertDialog dialog = new AlertDialog.Builder(this)
                  .setTitle(R.string.pick_place)
                  .setItems(likelyPlaceNames, listener)
                  .show();
      }
      

      Kotlin

      private fun openPlacesDialog() {
          // Ask the user to choose the place where they are now.
          val listener = DialogInterface.OnClickListener { dialog, which -> // The "which" argument contains the position of the selected item.
              val markerLatLng = likelyPlaceLatLngs[which]
              var markerSnippet = likelyPlaceAddresses[which]
              if (likelyPlaceAttributions[which] != null) {
                  markerSnippet = """
                      $markerSnippet
                      ${likelyPlaceAttributions[which]}
                      """.trimIndent()
              }
      
              // Add a marker for the selected place, with an info window
              // showing information about that place.
              map?.addMarker(MarkerOptions()
                  .title(likelyPlaceNames[which])
                  .position(markerLatLng!!)
                  .snippet(markerSnippet))
      
              // Position the map's camera at the location of the marker.
              map?.moveCamera(CameraUpdateFactory.newLatLngZoom(markerLatLng,
                  DEFAULT_ZOOM.toFloat()))
          }
      
          // Display the dialog.
          AlertDialog.Builder(this)
              .setTitle(R.string.pick_place)
              .setItems(likelyPlaceNames, listener)
              .show()
      }
      
    5. Создайте собственный макет для контента информационного окна. Это позволяет показывать в окне несколько строк. Сначала добавьте файл макета XML (custom_info_contents.xml), который содержит текстовое представление для заголовка информационного окна, и еще одно текстовое представление для фрагмента (иными словами, текстовый контент информационного окна).

      <?xml version="1.0" encoding="utf-8"?>
      <!--
       Copyright 2020 Google LLC
      
       Licensed under the Apache License, Version 2.0 (the "License");
       you may not use this file except in compliance with the License.
       You may obtain a copy of the License at
      
            http://www.apache.org/licenses/LICENSE-2.0
      
       Unless required by applicable law or agreed to in writing, software
       distributed under the License is distributed on an "AS IS" BASIS,
       WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
       See the License for the specific language governing permissions and
       limitations under the License.
      -->
      
      <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
          android:layout_width="wrap_content"
          android:layout_height="wrap_content"
          android:layoutDirection="locale"
          android:orientation="vertical">
          <TextView
              android:id="@+id/title"
              android:layout_width="wrap_content"
              android:layout_height="wrap_content"
              android:layout_gravity="center_horizontal"
              android:textColor="#ff000000"
              android:textStyle="bold" />
      
          <TextView
              android:id="@+id/snippet"
              android:layout_width="wrap_content"
              android:layout_height="wrap_content"
              android:textColor="#ff7f7f7f" />
      </LinearLayout>
      
      
    6. Реализуйте интерфейс InfoWindowAdapter, чтобы развернуть макет и загрузить контент информационного окна:

      Java

      // Use a custom info window adapter to handle multiple lines of text in the
      // info window contents.
      this.map.setInfoWindowAdapter(new GoogleMap.InfoWindowAdapter() {
      
          @Override
          // Return null here, so that getInfoContents() is called next.
          public View getInfoWindow(Marker arg0) {
              return null;
          }
      
          @Override
          public View getInfoContents(Marker marker) {
              // Inflate the layouts for the info window, title and snippet.
              View infoWindow = getLayoutInflater().inflate(R.layout.custom_info_contents,
                      (FrameLayout) findViewById(R.id.map), false);
      
              TextView title = infoWindow.findViewById(R.id.title);
              title.setText(marker.getTitle());
      
              TextView snippet = infoWindow.findViewById(R.id.snippet);
              snippet.setText(marker.getSnippet());
      
              return infoWindow;
          }
      });
      

      Kotlin

      // Use a custom info window adapter to handle multiple lines of text in the
      // info window contents.
      this.map?.setInfoWindowAdapter(object : InfoWindowAdapter {
          // Return null here, so that getInfoContents() is called next.
          override fun getInfoWindow(arg0: Marker): View? {
              return null
          }
      
          override fun getInfoContents(marker: Marker): View {
              // Inflate the layouts for the info window, title and snippet.
              val infoWindow = layoutInflater.inflate(R.layout.custom_info_contents,
                  findViewById<FrameLayout>(R.id.map), false)
              val title = infoWindow.findViewById<TextView>(R.id.title)
              title.text = marker.title
              val snippet = infoWindow.findViewById<TextView>(R.id.snippet)
              snippet.text = marker.snippet
              return infoWindow
          }
      })
      

    Сохранение состояния карты

    Сохраните информацию о положении камеры и местоположении устройства. Когда пользователь поворачивает устройство Android или изменяет параметры конфигурации, фреймворк Android останавливает и заново запускает объект activity для карты. Чтобы обеспечить удобство для пользователя, сохраните соответствующее состояние приложения и восстановите его при необходимости.

    Это руководство содержит весь код, который необходим для сохранения состояния карты. Дополнительную информацию вы можете найти в руководстве по использованию пакета savedInstanceState.

    1. В операции, работающей с картой, настройте основные значения для сохранения состояния объекта activity:

      Java

      private static final String KEY_CAMERA_POSITION = "camera_position";
      private static final String KEY_LOCATION = "location";
      

      Kotlin

      private const val KEY_CAMERA_POSITION = "camera_position"
      private const val KEY_LOCATION = "location"
      
    2. Реализуйте обратный вызов onSaveInstanceState(), чтобы сохранить состояние, когда операция будет приостановлена:

      Java

      @Override
      protected void onSaveInstanceState(Bundle outState) {
          if (map != null) {
              outState.putParcelable(KEY_CAMERA_POSITION, map.getCameraPosition());
              outState.putParcelable(KEY_LOCATION, lastKnownLocation);
          }
          super.onSaveInstanceState(outState);
      }
      

      Kotlin

      override fun onSaveInstanceState(outState: Bundle) {
          map?.let { map ->
              outState.putParcelable(KEY_CAMERA_POSITION, map.cameraPosition)
              outState.putParcelable(KEY_LOCATION, lastKnownLocation)
          }
          super.onSaveInstanceState(outState)
      }
      
    3. В методе onCreate() своей операции получите информацию о местоположении устройства и положении камеры карты, если это было ранее сохранено:

      Java

      // Retrieve location and camera position from saved instance state.
      if (savedInstanceState != null) {
          lastKnownLocation = savedInstanceState.getParcelable(KEY_LOCATION);
          cameraPosition = savedInstanceState.getParcelable(KEY_CAMERA_POSITION);
      }
      

      Kotlin

      if (savedInstanceState != null) {
          lastKnownLocation = savedInstanceState.getParcelable(KEY_LOCATION)
          cameraPosition = savedInstanceState.getParcelable(KEY_CAMERA_POSITION)
      }