1 /*
2  * Copyright (C) 2010, 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 
17 package android.location;
18 
19 import android.location.Country;
20 import android.location.ICountryListener;
21 
22 /**
23  * The API for detecting the country where the user is.
24  *
25  * {@hide}
26  */
27 interface ICountryDetector
28 {
29     /**
30      * Start detecting the country that the user is in.
31      * @return the country if it is available immediately, otherwise null will be returned.
32      */
detectCountry()33     Country detectCountry();
34 
35     /**
36      * Add a listener to receive the notification when the country is detected or changed.
37      */
addCountryListener(in ICountryListener listener)38     void addCountryListener(in ICountryListener listener);
39 
40     /**
41      * Remove the listener
42      */
removeCountryListener(in ICountryListener listener)43     void removeCountryListener(in ICountryListener listener);
44 }