Merge "Update provider javadocs"

     * {@link SecurityException} if the location permissions were not sufficient to use the

     * specified provider.

     *

     * @param provider the name of the provider

     * @param provider a provider listed by {@link #getAllProviders()}

     * @return true if the provider exists and is enabled

     *

     * @throws IllegalArgumentException if provider is null

     * {@link SecurityException} if the location permissions were not sufficient to use the

     * specified provider.

     *

     * @param provider the name of the provider

     * @param provider a provider listed by {@link #getAllProviders()}

     * @param userHandle the user to query

     * @return true if the provider exists and is enabled

     *

     * functions as a best effort. It should not be relied on in any meaningful sense as providers

     * may no longer be enabled or disabled by clients.

     *

     * @param provider the name of the provider

     * @param enabled true to enable the provider. false to disable the provider

     * @param provider a provider listed by {@link #getAllProviders()}

     * @param enabled whether to enable or disable the provider

     * @param userHandle the user to set

     * @return true if the value was set, false otherwise

     *

     * will always attempt to return a current location, but will potentially use additional power

     * in the course of the attempt as compared to this method.

     *

     * @param provider the name of the provider

     * @param provider a provider listed by {@link #getAllProviders()}

     * @return the last known location for the given provider, or null if not available

     * @throws SecurityException if no suitable permission is present

     * @throws IllegalArgumentException if provider is null or doesn't exist

     * determine a valid location fix more often than while in the foreground. Background

     * applications may be throttled in their location accesses to some degree.

     *

     * @param provider           the name of the provider with which to register

     * @param provider           a provider listed by {@link #getAllProviders()}

     * @param cancellationSignal an optional signal that allows for cancelling this call

     * @param executor           the callback will take place on this {@link Executor}

     * @param consumer           the callback invoked with either a {@link Location} or null

     * <p>See {@link #requestLocationUpdates(String, long, float, LocationListener, Looper)} for

     * more detail on how to use this method.

     *

     * @param provider the name of the provider with which to register

     * @param provider a provider listed by {@link #getAllProviders()}

     * @param listener the listener to receive location updates

     * @param looper   the looper handling listener callbacks, or null to use the looper of the

     *                 calling thread

     * <p>See {@link #requestLocationUpdates(long, float, Criteria, PendingIntent)} for more detail

     * on how to use this method.

     *

     * @param provider      the name of the provider with which to register

     * @param provider      a provider listed by {@link #getAllProviders()}

     * @param pendingIntent the pending intent to send location updates

     *

     * @throws IllegalArgumentException if provider is null or doesn't exist

     *

     * <p>To unregister for location updates, use {@link #removeUpdates(LocationListener)}.

     *

     * @param provider the name of the provider with which to register

     * @param provider     a provider listed by {@link #getAllProviders()}

     * @param minTimeMs    minimum time interval between location updates in milliseconds

     * @param minDistanceM minimum distance between location updates in meters

     * @param listener     the listener to receive location updates

     * <p>See {@link #requestLocationUpdates(String, long, float, LocationListener)}

     * for more detail on how this method works.

     *

     * @param provider the name of the provider with which to register

     * @param provider     a provider listed by {@link #getAllProviders()}

     * @param minTimeMs    minimum time interval between location updates in milliseconds

     * @param minDistanceM minimum distance between location updates in meters

     * @param listener     the listener to receive location updates

     * <p>See {@link #requestLocationUpdates(String, long, float, LocationListener)}

     * for more detail on how this method works.

     *

     * @param provider the name of the provider with which to register

     * @param provider     a provider listed by {@link #getAllProviders()}

     * @param minTimeMs    minimum time interval between location updates in milliseconds

     * @param minDistanceM minimum distance between location updates in meters

     * @param executor     the executor handling listener callbacks

     * <p>See {@link #requestLocationUpdates(String, long, float, LocationListener)}

     * for more detail on how this method works.

     *

     * @param provider the name of the provider with which to register

     * @param provider      a provider listed by {@link #getAllProviders()}

     * @param minTimeMs     minimum time interval between location updates in milliseconds

     * @param minDistanceM  minimum distance between location updates in meters

     * @param pendingIntent the pending intent to send location updates

     * Returns the information about the location provider with the given name, or null if no

     * provider exists by that name.

     *

     * @param provider the provider name

     * @param provider a provider listed by {@link #getAllProviders()}

     * @return location provider information, or null if provider does not exist

     *

     * @throws IllegalArgumentException if provider is null

     * Sends additional commands to a location provider. Can be used to support provider specific

     * extensions to the Location Manager API.

     *

     * @param provider name of the location provider

     * @param provider a provider listed by {@link #getAllProviders()}

     * @param command  name of the command to send to the provider

     * @param extras   optional arguments for the command, or null

     * @return true always, the return value may be ignored