ILocationManager.aidl revision 48c5eb018b1731bd47caccd43cda2cd36ebc271f
1/* 2 * Copyright (C) 2007, The Android Open Source Project 3 * 4 * Licensed under the Apache License, Version 2.0 (the "License"); 5 * you may not use this file except in compliance with the License. 6 * You may obtain a copy of the License at 7 * 8 * http://www.apache.org/licenses/LICENSE-2.0 9 * 10 * Unless required by applicable law or agreed to in writing, software 11 * distributed under the License is distributed on an "AS IS" BASIS, 12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13 * See the License for the specific language governing permissions and 14 * limitations under the License. 15 */ 16 17package android.location; 18 19import android.app.PendingIntent; 20import android.location.Address; 21import android.location.Criteria; 22import android.location.GeocoderParams; 23import android.location.IGeocodeProvider; 24import android.location.IGpsStatusListener; 25import android.location.ILocationListener; 26import android.location.Location; 27import android.os.Bundle; 28 29/** 30 * System private API for talking with the location service. 31 * 32 * {@hide} 33 */ 34interface ILocationManager 35{ 36 List<String> getAllProviders(); 37 List<String> getProviders(in Criteria criteria, boolean enabledOnly); 38 String getBestProvider(in Criteria criteria, boolean enabledOnly); 39 boolean providerMeetsCriteria(String provider, in Criteria criteria); 40 41 void requestLocationUpdates(String provider, in Criteria criteria, long minTime, float minDistance, 42 boolean singleShot, in ILocationListener listener, String packageName); 43 void requestLocationUpdatesPI(String provider, in Criteria criteria, long minTime, float minDistance, 44 boolean singleShot, in PendingIntent intent, String packageName); 45 void removeUpdates(in ILocationListener listener, String packageName); 46 void removeUpdatesPI(in PendingIntent intent, String packageName); 47 48 boolean addGpsStatusListener(IGpsStatusListener listener); 49 void removeGpsStatusListener(IGpsStatusListener listener); 50 51 // for reporting callback completion 52 void locationCallbackFinished(ILocationListener listener); 53 54 boolean sendExtraCommand(String provider, String command, inout Bundle extras); 55 56 void addProximityAlert(double latitude, double longitude, float distance, 57 long expiration, in PendingIntent intent, String packageName); 58 void removeProximityAlert(in PendingIntent intent); 59 60 Bundle getProviderInfo(String provider); 61 boolean isProviderEnabled(String provider); 62 63 Location getLastKnownLocation(String provider, String packageName); 64 65 // Used by location providers to tell the location manager when it has a new location. 66 // Passive is true if the location is coming from the passive provider, in which case 67 // it need not be shared with other providers. 68 void reportLocation(in Location location, boolean passive); 69 70 boolean geocoderIsPresent(); 71 String getFromLocation(double latitude, double longitude, int maxResults, 72 in GeocoderParams params, out List<Address> addrs); 73 String getFromLocationName(String locationName, 74 double lowerLeftLatitude, double lowerLeftLongitude, 75 double upperRightLatitude, double upperRightLongitude, int maxResults, 76 in GeocoderParams params, out List<Address> addrs); 77 78 void addTestProvider(String name, boolean requiresNetwork, boolean requiresSatellite, 79 boolean requiresCell, boolean hasMonetaryCost, boolean supportsAltitude, 80 boolean supportsSpeed, boolean supportsBearing, int powerRequirement, int accuracy); 81 void removeTestProvider(String provider); 82 void setTestProviderLocation(String provider, in Location loc); 83 void clearTestProviderLocation(String provider); 84 void setTestProviderEnabled(String provider, boolean enabled); 85 void clearTestProviderEnabled(String provider); 86 void setTestProviderStatus(String provider, int status, in Bundle extras, long updateTime); 87 void clearTestProviderStatus(String provider); 88 89 // for NI support 90 boolean sendNiResponse(int notifId, int userResponse); 91} 92