ILocationManager.aidl revision 9db3d07b9620b4269ab33f78604a36327e536ce1
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.IGeocodeProvider; 22import android.location.IGpsStatusListener; 23import android.location.ILocationListener; 24import android.location.ILocationProvider; 25import android.location.Location; 26import android.os.Bundle; 27 28/** 29 * System private API for talking with the location service. 30 * 31 * {@hide} 32 */ 33interface ILocationManager 34{ 35 List getAllProviders(); 36 List getProviders(boolean enabledOnly); 37 38 void requestLocationUpdates(String provider, long minTime, float minDistance, 39 in ILocationListener listener); 40 void requestLocationUpdatesPI(String provider, long minTime, float minDistance, 41 in PendingIntent intent); 42 void removeUpdates(in ILocationListener listener); 43 void removeUpdatesPI(in PendingIntent intent); 44 45 boolean addGpsStatusListener(IGpsStatusListener listener); 46 void removeGpsStatusListener(IGpsStatusListener listener); 47 48 // for reporting callback completion 49 void locationCallbackFinished(ILocationListener listener); 50 51 boolean sendExtraCommand(String provider, String command, inout Bundle extras); 52 53 void addProximityAlert(double latitude, double longitude, float distance, 54 long expiration, in PendingIntent intent); 55 void removeProximityAlert(in PendingIntent intent); 56 57 Bundle getProviderInfo(String provider); 58 boolean isProviderEnabled(String provider); 59 60 Location getLastKnownLocation(String provider); 61 62 /* used by location providers to tell the location manager when it has a new location */ 63 void reportLocation(in Location location); 64 65 String getFromLocation(double latitude, double longitude, int maxResults, 66 String language, String country, String variant, String appName, out List<Address> addrs); 67 String getFromLocationName(String locationName, 68 double lowerLeftLatitude, double lowerLeftLongitude, 69 double upperRightLatitude, double upperRightLongitude, int maxResults, 70 String language, String country, String variant, String appName, out List<Address> addrs); 71 72 void addTestProvider(String name, boolean requiresNetwork, boolean requiresSatellite, 73 boolean requiresCell, boolean hasMonetaryCost, boolean supportsAltitude, 74 boolean supportsSpeed, boolean supportsBearing, int powerRequirement, int accuracy); 75 void removeTestProvider(String provider); 76 void setTestProviderLocation(String provider, in Location loc); 77 void clearTestProviderLocation(String provider); 78 void setTestProviderEnabled(String provider, boolean enabled); 79 void clearTestProviderEnabled(String provider); 80 void setTestProviderStatus(String provider, int status, in Bundle extras, long updateTime); 81 void clearTestProviderStatus(String provider); 82 83 /* for installing external Location Providers */ 84 void installLocationProvider(String name, ILocationProvider provider); 85 void installGeocodeProvider(IGeocodeProvider provider); 86 87 // for NI support 88 boolean sendNiResponse(int notifId, int userResponse); 89} 90