Geçerli Yeri Seçin ve Haritadaki Ayrıntıları Göster

Bir Android cihazın geçerli konumunu nasıl bulacağınızı ve söz konusu konumdaki yerin (işletme veya başka bir önemli nokta) ayrıntılarını görüntülemeyi öğrenin. Android için Haritalar SDK'sı, Android için Yerler SDK'sı ve Google Play Hizmetleri konum API'lerindeki çok kaynaklı konum sağlayıcısını kullanarak Android uygulaması oluşturmak için bu eğiticideki adımları uygulayın.

Not: Bu eğitim, Google Play Hizmetleri'nin 11.2.0 veya sonraki bir sürümünü gerektirir.

Kodu alın

GitHub'dan Google Haritalar Android API v2 Örnek deposunu klonlayın veya indirin.

Etkinliğin Java sürümünü görüntüleyin:

Kodu Göster / Gizle

    // 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.PLACES_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;
        if (requestCode
            == 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;
            }
        } else {
            super.onRequestPermissionsResult(requestCode, permissions, grantResults);
        }
        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());
        }
    }
}

    

Etkinliğin Kotlin sürümünü görüntüleyin:

Kodu Göster / Gizle

    // 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.
     */
    @SuppressLint("MissingPermission")
    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
                }
            }
            else -> super.onRequestPermissionsResult(requestCode, permissions, grantResults)
        }
        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()
            }

            if (markerLatLng == null) {
                return@OnClickListener
            }

            // 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.
     */
    @SuppressLint("MissingPermission")
    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
    }
}

    

Geliştirme projenizi oluşturun

Android Studio'da eğitim projesini oluşturmak için aşağıdaki adımları uygulayın.

1. Android Studio'yu indirin ve yükleyin.
2. Android Studio'ya Google Play hizmetleri paketini ekleyin.
3. Bu eğiticiyi okumaya başladığınızda bunu yapmadıysanız Google Haritalar Android API v2 Örnek deposunu klonlayın veya indirin.

4. Eğitim projesini içe aktarın:

   • Android Studio'da Dosya > Yeni > Projeyi İçe Aktar'ı seçin.
   • İndirdikten sonra Google Haritalar Android API v2 Örnekleri deposunu kaydettiğiniz konuma gidin.
   • CurrentPlaceDetailsOnMap projesini şu konumda bulun:
     PATH-TO-SAVED-REPO/android-samples/tutorials/java/CurrentPlaceDetailsOnMap (Java) veya
     PATH-TO-SAVED-REPO/android-samples/tutorials/kotlin/CurrentPlaceDetailsOnMap (Kotlin)
   • Proje dizinini seçin ve ardından Aç'ı tıklayın. Android Studio artık Gradle oluşturma aracını kullanarak projenizi oluşturuyor.

Gerekli API'leri etkinleştirin ve API anahtarı alın

Bu eğiticiyi tamamlamak için gerekli API'lerin etkinleştirildiği bir Google Cloud projesine ve Android için Haritalar SDK'sını kullanmak üzere yetkilendirilmiş bir API anahtarına ihtiyacınız vardır. Daha fazla bilgi için:

• Google Cloud projenizi oluşturun
• API anahtarı kullanma

Not: Bu eğitim, Places API'nin yanı sıra Android için Haritalar SDK'sını da etkinleştirmenizi gerektirir.

Etkin API'lerinizin API'lerini görüntülemek için Cloud Console'da Google Haritalar Platformu sayfasına gidin ve projenizi seçin:

Google Haritalar Platformu sayfasına gidin

Projenizde Places API etkin değilse bunu etkinleştirmeniz gerekir:

Place'ler API'yi etkinleştirme

API anahtarınıza herhangi bir kısıtlama eklerseniz anahtara Places API'yi eklediğinizden emin olun. Daha fazla bilgi için API Anahtarlarını Kullanma bölümüne bakın.

API anahtarını uygulamanıza ekleme

1. Projenizin local.properties dosyasını açın.

2. Aşağıdaki dizeyi ekleyin ve YOUR_API_KEY yerine API anahtarınızın değerini girin:

   MAPS_API_KEY=YOUR_API_KEY

   Android için Secrets Gradle Plugin derlediğiniz API anahtarını kopyalar ve Android manifest dosyasında derleme değişkeni olarak kullanıma sunar.

Uygulamanızı derleyip çalıştırma

1. Bilgisayarınıza bir Android cihaz bağlayın. Android cihazınızda geliştirici seçeneklerini etkinleştirmek ve sisteminizi cihazı algılayacak şekilde yapılandırmak için instructions uygulayın.

   Alternatif olarak, sanal bir cihaz yapılandırmak için Android Virtual Device (AVD) Manager'ı kullanabilirsiniz. Emülatör seçerken Google API'lerini içeren bir görüntü seçtiğinizden emin olun. Daha fazla bilgi için Android Studio Projesi Oluşturma konusuna bakın.

2. Android Studio'da, Çalıştır menü seçeneğini (veya oynat düğmesi simgesini) tıklayın. İstendiği şekilde bir cihaz seçin.

Android Studio, uygulamayı oluşturmak için Gradle'ı çağırır ve daha sonra, uygulamayı cihazda veya emülatörde çalıştırır. Bu sayfadaki görüntüye benzer şekilde, mevcut konumunuzun çevresinde ortalanmış bir dizi işaretçi bulunan bir harita görürsünüz.

1. Mevcut konumunuza yakın yerlerin (işletme veya başka bir önemli nokta) listesini açmak için Yer Al'ı seçin.
2. Listeden bir yer seçin. Seçili yer için haritaya bir işaretçi eklenir.

Sorun giderme:

• Harita görmüyorsanız bir API anahtarı alıp almadığınızı ve bu anahtarı yukarıda açıklandığı gibi uygulamaya eklediğinizden emin olun. API anahtarıyla ilgili hata mesajlarının olup olmadığını görmek için Android Studio'nun Android Monitörü günlük kaydını kontrol edin.
• Haritada Sidney Liman Köprüsü'nde (uygulamada belirtilen varsayılan konum) yalnızca tek bir işaretçi gösteriliyorsa uygulamaya konum izni verdiğinizden emin olun. Uygulama, Android izin kılavuzunda açıklanan kalıbı izleyerek çalışma zamanında konum izni ister. İzinleri, Ayarlar > Uygulamalar > uygulama adı > İzinler > Konum'u seçerek doğrudan cihazda da ayarlayabileceğinizi unutmayın. Kodunuzdaki izinleri nasıl yöneteceğinizle ilgili ayrıntılar için aşağıdaki uygulamanızda konum izni isteme rehberine bakın.
• Günlükleri görüntülemek ve uygulamada hata ayıklamak için Android Studio hata ayıklama araçlarını kullanın.

Kodu anlama

Eğiticinin bu bölümünde, benzer bir uygulamayı nasıl oluşturacağınızı anlamanıza yardımcı olmak için CurrentPlaceDetailsOnMap uygulamasının en önemli bölümleri açıklanmaktadır.

Places API istemcisini örneklendirme

Bu nesneler, Android için Yerler SDK'sına birincil giriş noktalarıdır:

• Places sınıfı, Android için Yerler SDK'sı için istemciler oluşturup yönetir.
• PlacesClient arayüzü, cihazın mevcut konumunu ve bu konumun yakınındaki yerleri alır.

LocationServices arayüzü, Android konum hizmetlerinin ana giriş noktasıdır.

API'leri kullanmak için parçanızın veya etkinliğinizin onCreate() yönteminde aşağıdakileri yapın:

1. Bir Places nesnesini başlatın.
2. Bir PlacesClient nesnesi oluşturun.
3. Bir FusedLocationProviderClient nesnesi oluşturun.

Örneğin:

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)

}

Konum izni iste

Uygulamanızın, cihazın konumunu belirlemek ve kullanıcının haritadaki Konumum düğmesine dokunabilmesi için konum izni istemesi gerekir.

Bu eğitim, ayrıntılı konum izni istemek için gereken kodu sağlar. Daha fazla bilgi için Android izinleri rehberine bakın.

1. İzni Android manifest dosyanızdaki <manifest> öğesinin alt öğesi olarak ekleyin:

   <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. Uygulamanızda çalışma zamanında istenen izinleri isteyerek kullanıcıya konum izni verme veya izni reddetme olanağı tanıyın. Aşağıdaki kod, kullanıcının ayrıntılı konum izni verip vermediğini kontrol eder. Aksi takdirde izin ister:

   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);
       }
   }
   MapsActivityCurrentPlace.java
   

   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)
       }
   }
   MapsActivityCurrentPlace.kt
   

3. İzin isteğinin sonucunu işlemek için onRequestPermissionsResult() geri çağırmasını geçersiz kılın:

   Java

   @Override
   public void onRequestPermissionsResult(int requestCode,
                                          @NonNull String[] permissions,
                                          @NonNull int[] grantResults) {
       locationPermissionGranted = false;
       if (requestCode
           == 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;
           }
       } else {
           super.onRequestPermissionsResult(requestCode, permissions, grantResults);
       }
       updateLocationUI();
   }
   MapsActivityCurrentPlace.java
   

   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
               }
           }
           else -> super.onRequestPermissionsResult(requestCode, permissions, grantResults)
       }
       updateLocationUI()
   }
   MapsActivityCurrentPlace.kt
   

   Bu eğiticinin sonraki bir bölümünde updateLocationUI() yöntemi açıklanmaktadır.

Harita ekleyin

Android için Haritalar SDK'sını kullanarak bir harita görüntüleyin.

1. Etkinliğinizin düzen dosyasına (activity_maps.xml) bir <fragment> öğesi ekleyin. Bu öğe, haritanın kapsayıcısı işlevini yerine getirmek ve GoogleMap nesnesine erişim sağlamak için bir SupportMapFragment tanımlar. Eğitimde, Android çerçevesinin önceki sürümleriyle geriye dönük uyumluluk sağlamak için harita parçasının Android destek kitaplığı sürümü kullanılır.

   <!--
    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. Etkinliğinizin onCreate() yönteminde, düzen dosyasını içerik görünümü olarak ayarlayın:

   Java

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

   Kotlin

   override fun onCreate(savedInstanceState: Bundle?) {
       super.onCreate(savedInstanceState)
   
   
       // Retrieve the content view that renders the map.
       setContentView(R.layout.activity_maps)
   
   }
   MapsActivityCurrentPlace.kt
   

3. GoogleMap nesnesi kullanılabilir olduğunda haritayı ayarlamak için OnMapReadyCallback arayüzünü uygulayın ve onMapReady() yöntemini geçersiz kılın:

   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();
   }
   MapsActivityCurrentPlace.java
   

   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()
   }
   MapsActivityCurrentPlace.kt
   

4. Etkinliğinizin onCreate() yönteminde, FragmentManager.findFragmentById() yöntemini çağırarak harita parçasının yerini belirleyin. Ardından harita geri çağırmaya kaydolmak için getMapAsync() kullanın:

   Java

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

   Kotlin

   val mapFragment = supportFragmentManager
       .findFragmentById(R.id.map) as SupportMapFragment?
   mapFragment?.getMapAsync(this)
   MapsActivityCurrentPlace.kt
   

5. Harita üzerindeki konum denetimlerini ayarlamak için bir updateLocationUI() yöntemi yazın. Kullanıcı konum izni verdiyse Konumum katmanını ve harita üzerinde ilgili denetimi etkinleştirin. Aksi takdirde, katmanı ve denetimi devre dışı bırakıp geçerli konumu null değerine ayarlayın:

   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());
       }
   }
   MapsActivityCurrentPlace.java
   

   Kotlin

   @SuppressLint("MissingPermission")
   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)
       }
   }
   MapsActivityCurrentPlace.kt
   

Android cihazın konumunu alma ve haritayı konumlandırma

Cihazın son bilinen konumunu bulmak için çok kaynaklı konum sağlayıcısını kullanın ve ardından haritayı konumlandırmak için o konumu kullanın. Eğitim, ihtiyacınız olan kodu sağlar. Cihazın konumunu alma hakkında daha fazla bilgi için Google Play Hizmetleri konum API'lerindeki çok kaynaklı konum sağlayıcısı kılavuzuna bakın.

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);
    }
}
MapsActivityCurrentPlace.java

Kotlin

@SuppressLint("MissingPermission")
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)
    }
}
MapsActivityCurrentPlace.kt

Mevcut yeri al

Cihazın mevcut konumundaki muhtemel yerlerin listesini almak üzere Android için Yerler SDK'sını kullanın. Bu bağlamda yer, işletme veya başka bir önemli noktadır.

Bu eğitim, kullanıcı Yer Al düğmesini tıkladığında geçerli yeri alır. Kullanıcıya, aralarından seçim yapabileceği olası yerlerin bir listesini sunar ve ardından haritada, seçilen yerin konumuna bir işaretçi ekler. Eğiticide, Android için Yerler SDK'sı ile etkileşim kurmak için ihtiyacınız olan kod sağlanır. Daha fazla bilgi için geçerli yeri bulma rehberine bakın.

1. Seçenekler menüsü için bir düzen dosyası (current_place_menu.xml) oluşturun ve seçenekler menüsünü ayarlamak için onCreateOptionsMenu() yöntemini geçersiz kılın. Kodu görmek için birlikte verilen örnek uygulamaya göz atın.
2. Kullanıcı Yer Alma seçeneğini tıkladığında mevcut yeri almak için onOptionsItemSelected() yöntemini geçersiz kılın:

   Java

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

   Kotlin

   override fun onOptionsItemSelected(item: MenuItem): Boolean {
       if (item.itemId == R.id.option_get_place) {
           showCurrentPlace()
       }
       return true
   }
   MapsActivityCurrentPlace.kt
   

3. Cihazın mevcut konumundaki muhtemel yerlerin listesini almak için bir showCurrentPlace() yöntemi oluşturun:

   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();
       }
   }
   MapsActivityCurrentPlace.java
   

   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()
       }
   }
   MapsActivityCurrentPlace.kt
   

4. Kullanıcının olası yerler listesinden bir yer seçmesine olanak tanıyan bir form görüntülemek için openPlacesDialog() yöntemi oluşturun. Seçili yer için harita üzerinde bir işaretçi ekleyin. İşaretçi içeriği, yerin adı ve adresinin yanı sıra API'nin sağladığı tüm atıfları içerir:

   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();
   }
   MapsActivityCurrentPlace.java
   

   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()
           }
   
           if (markerLatLng == null) {
               return@OnClickListener
           }
   
           // 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()
   }
   MapsActivityCurrentPlace.kt
   

5. Bilgi penceresi içeriği için özel bir düzen oluşturun. Bu, bilgi penceresinde birden çok içerik satırının görüntülenmesini mümkün kılar. Öncelikle, bilgi penceresi başlığı için metin görünümü içeren custom_info_contents.xml XML düzen dosyasını ve snippet için de başka bir metin görünümü (bilgi penceresinin metin içeriği) ekleyin:

   <?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. Düzeni büyütmek ve bilgi penceresi içeriğini yüklemek için InfoWindowAdapter arayüzünü uygulayın:

   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;
       }
   });
   MapsActivityCurrentPlace.java
   

   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
       }
   })
   MapsActivityCurrentPlace.kt
   

Not: Varsayılan olarak Android için Haritalar SDK'sı, kullanıcı bir işaretçiye dokunduğunda bilgi penceresinin içeriğini görüntüler. Varsayılan davranışı kullanmaktan memnunsanız işaretçi için tıklama işleyici eklemenize gerek yoktur.

Haritanın durumunu kaydetme

Haritanın kamera konumunu ve cihazın konumunu kaydedin. Kullanıcı bir Android cihazı döndürdüğünde veya yapılandırma değişiklikleri yaptığında, Android çerçevesi harita etkinliğini yok eder ve yeniden oluşturur. Sorunsuz bir kullanıcı deneyimi sağlamak için ilgili uygulama durumunu depolamak ve gerektiğinde geri yüklemek iyi bir fikirdir.

Haritanın durumunu kaydetmek için ihtiyacınız olan tüm kodları bu eğiticide bulabilirsiniz. Daha fazla bilgi için savedInstanceState paketi rehberine bakın.

1. Harita etkinliğinizde, etkinlik durumunu depolamak için anahtar değerleri ayarlayın:

   Java

   private static final String KEY_CAMERA_POSITION = "camera_position";
   private static final String KEY_LOCATION = "location";
   MapsActivityCurrentPlace.java
   

   Kotlin

   private const val KEY_CAMERA_POSITION = "camera_position"
   private const val KEY_LOCATION = "location"
   MapsActivityCurrentPlace.kt
   

2. Etkinlik duraklatıldığında durumu kaydetmek için onSaveInstanceState() geri çağırmasını uygulayın:

   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);
   }
   MapsActivityCurrentPlace.java
   

   Kotlin

   override fun onSaveInstanceState(outState: Bundle) {
       map?.let { map ->
           outState.putParcelable(KEY_CAMERA_POSITION, map.cameraPosition)
           outState.putParcelable(KEY_LOCATION, lastKnownLocation)
       }
       super.onSaveInstanceState(outState)
   }
   MapsActivityCurrentPlace.kt
   

3. Etkinliğinizin onCreate() yönteminde, daha önce kaydedilmişse cihazın konumunu ve haritanın kamera konumunu alın:

   Java

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

   Kotlin

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

Tebrikler! Mevcut yeri Google haritasında gösteren bir Android uygulaması oluşturdunuz. Ayrıca Android için Haritalar SDK'sını, Android için Yerler SDK'sını ve çok kaynaklı konum sağlayıcısını kullanmayı da öğrendiniz.