| /* |
| * Copyright (C) 2007, The Android Open Source Project |
| * |
| * 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 android.location; |
| |
| import android.app.PendingIntent; |
| import android.location.Address; |
| import android.location.Criteria; |
| import android.location.GeocoderParams; |
| import android.location.Geofence; |
| import android.location.IBatchedLocationCallback; |
| import android.location.IGnssMeasurementsListener; |
| import android.location.IGnssStatusListener; |
| import android.location.IGnssNavigationMessageListener; |
| import android.location.ILocationListener; |
| import android.location.Location; |
| import android.location.LocationRequest; |
| import android.os.Bundle; |
| |
| import com.android.internal.location.ProviderProperties; |
| |
| /** |
| * System private API for talking with the location service. |
| * |
| * @hide |
| */ |
| interface ILocationManager |
| { |
| void requestLocationUpdates(in LocationRequest request, in ILocationListener listener, |
| in PendingIntent intent, String packageName); |
| void removeUpdates(in ILocationListener listener, in PendingIntent intent, String packageName); |
| |
| void requestGeofence(in LocationRequest request, in Geofence geofence, |
| in PendingIntent intent, String packageName); |
| void removeGeofence(in Geofence fence, in PendingIntent intent, String packageName); |
| |
| Location getLastLocation(in LocationRequest request, String packageName); |
| |
| boolean registerGnssStatusCallback(IGnssStatusListener callback, String packageName); |
| void unregisterGnssStatusCallback(IGnssStatusListener callback); |
| |
| boolean geocoderIsPresent(); |
| String getFromLocation(double latitude, double longitude, int maxResults, |
| in GeocoderParams params, out List<Address> addrs); |
| String getFromLocationName(String locationName, |
| double lowerLeftLatitude, double lowerLeftLongitude, |
| double upperRightLatitude, double upperRightLongitude, int maxResults, |
| in GeocoderParams params, out List<Address> addrs); |
| |
| boolean sendNiResponse(int notifId, int userResponse); |
| |
| boolean addGnssMeasurementsListener(in IGnssMeasurementsListener listener, in String packageName); |
| void removeGnssMeasurementsListener(in IGnssMeasurementsListener listener); |
| |
| boolean addGnssNavigationMessageListener( |
| in IGnssNavigationMessageListener listener, |
| in String packageName); |
| void removeGnssNavigationMessageListener(in IGnssNavigationMessageListener listener); |
| |
| int getGnssYearOfHardware(); |
| String getGnssHardwareModelName(); |
| |
| int getGnssBatchSize(String packageName); |
| boolean addGnssBatchingCallback(in IBatchedLocationCallback callback, String packageName); |
| void removeGnssBatchingCallback(); |
| boolean startGnssBatch(long periodNanos, boolean wakeOnFifoFull, String packageName); |
| void flushGnssBatch(String packageName); |
| boolean stopGnssBatch(); |
| boolean injectLocation(in Location location); |
| |
| // --- deprecated --- |
| @UnsupportedAppUsage |
| List<String> getAllProviders(); |
| List<String> getProviders(in Criteria criteria, boolean enabledOnly); |
| String getBestProvider(in Criteria criteria, boolean enabledOnly); |
| boolean providerMeetsCriteria(String provider, in Criteria criteria); |
| ProviderProperties getProviderProperties(String provider); |
| @UnsupportedAppUsage |
| String getNetworkProviderPackage(); |
| |
| boolean isProviderEnabledForUser(String provider, int userId); |
| boolean setProviderEnabledForUser(String provider, boolean enabled, int userId); |
| boolean isLocationEnabledForUser(int userId); |
| void setLocationEnabledForUser(boolean enabled, int userId); |
| void addTestProvider(String name, in ProviderProperties properties, String opPackageName); |
| void removeTestProvider(String provider, String opPackageName); |
| void setTestProviderLocation(String provider, in Location loc, String opPackageName); |
| void clearTestProviderLocation(String provider, String opPackageName); |
| void setTestProviderEnabled(String provider, boolean enabled, String opPackageName); |
| void clearTestProviderEnabled(String provider, String opPackageName); |
| void setTestProviderStatus(String provider, int status, in Bundle extras, long updateTime, |
| String opPackageName); |
| void clearTestProviderStatus(String provider, String opPackageName); |
| |
| boolean sendExtraCommand(String provider, String command, inout Bundle extras); |
| |
| // --- internal --- |
| |
| // Used by location providers to tell the location manager when it has a new location. |
| // Passive is true if the location is coming from the passive provider, in which case |
| // it need not be shared with other providers. |
| @UnsupportedAppUsage |
| void reportLocation(in Location location, boolean passive); |
| |
| // Used when a (initially Gnss) Location batch arrives |
| void reportLocationBatch(in List<Location> locations); |
| |
| // for reporting callback completion |
| void locationCallbackFinished(ILocationListener listener); |
| |
| // used by gts tests to verify throttling whitelist |
| String[] getBackgroundThrottlingWhitelist(); |
| } |