1ccb4c318aa5150ba49b7e7878d20b4787d6bf723Laurent Tu/* 2ccb4c318aa5150ba49b7e7878d20b4787d6bf723Laurent Tu * Copyright (C) 2010 The Android Open Source Project 3ccb4c318aa5150ba49b7e7878d20b4787d6bf723Laurent Tu * 4ccb4c318aa5150ba49b7e7878d20b4787d6bf723Laurent Tu * Licensed under the Apache License, Version 2.0 (the "License"); 5ccb4c318aa5150ba49b7e7878d20b4787d6bf723Laurent Tu * you may not use this file except in compliance with the License. 6ccb4c318aa5150ba49b7e7878d20b4787d6bf723Laurent Tu * You may obtain a copy of the License at 7ccb4c318aa5150ba49b7e7878d20b4787d6bf723Laurent Tu * 8ccb4c318aa5150ba49b7e7878d20b4787d6bf723Laurent Tu * http://www.apache.org/licenses/LICENSE-2.0 9ccb4c318aa5150ba49b7e7878d20b4787d6bf723Laurent Tu * 10ccb4c318aa5150ba49b7e7878d20b4787d6bf723Laurent Tu * Unless required by applicable law or agreed to in writing, software 11ccb4c318aa5150ba49b7e7878d20b4787d6bf723Laurent Tu * distributed under the License is distributed on an "AS IS" BASIS, 12ccb4c318aa5150ba49b7e7878d20b4787d6bf723Laurent Tu * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13ccb4c318aa5150ba49b7e7878d20b4787d6bf723Laurent Tu * See the License for the specific language governing permissions and 14ccb4c318aa5150ba49b7e7878d20b4787d6bf723Laurent Tu * limitations under the License. 15ccb4c318aa5150ba49b7e7878d20b4787d6bf723Laurent Tu */ 16ccb4c318aa5150ba49b7e7878d20b4787d6bf723Laurent Tu 17ccb4c318aa5150ba49b7e7878d20b4787d6bf723Laurent Tupackage com.android.location.provider; 18ccb4c318aa5150ba49b7e7878d20b4787d6bf723Laurent Tu 19ccb4c318aa5150ba49b7e7878d20b4787d6bf723Laurent Tuimport android.os.IBinder; 20ccb4c318aa5150ba49b7e7878d20b4787d6bf723Laurent Tu 21ccb4c318aa5150ba49b7e7878d20b4787d6bf723Laurent Tuimport android.location.Address; 22ccb4c318aa5150ba49b7e7878d20b4787d6bf723Laurent Tuimport android.location.GeocoderParams; 23ccb4c318aa5150ba49b7e7878d20b4787d6bf723Laurent Tuimport android.location.IGeocodeProvider; 24ccb4c318aa5150ba49b7e7878d20b4787d6bf723Laurent Tu 25ccb4c318aa5150ba49b7e7878d20b4787d6bf723Laurent Tuimport java.util.List; 26ccb4c318aa5150ba49b7e7878d20b4787d6bf723Laurent Tu 27ccb4c318aa5150ba49b7e7878d20b4787d6bf723Laurent Tu/** 28ccb4c318aa5150ba49b7e7878d20b4787d6bf723Laurent Tu * Base class for geocode providers implemented as unbundled services. 29ccb4c318aa5150ba49b7e7878d20b4787d6bf723Laurent Tu * 30ccb4c318aa5150ba49b7e7878d20b4787d6bf723Laurent Tu * <p>Geocode providers can be implemented as services and return the result of 31ccb4c318aa5150ba49b7e7878d20b4787d6bf723Laurent Tu * {@link GeocodeProvider#getBinder()} in its getBinder() method. 32ccb4c318aa5150ba49b7e7878d20b4787d6bf723Laurent Tu * 33ccb4c318aa5150ba49b7e7878d20b4787d6bf723Laurent Tu * <p>IMPORTANT: This class is effectively a public API for unbundled 34ccb4c318aa5150ba49b7e7878d20b4787d6bf723Laurent Tu * applications, and must remain API stable. See README.txt in the root 35ccb4c318aa5150ba49b7e7878d20b4787d6bf723Laurent Tu * of this package for more information. 36ccb4c318aa5150ba49b7e7878d20b4787d6bf723Laurent Tu */ 37ccb4c318aa5150ba49b7e7878d20b4787d6bf723Laurent Tupublic abstract class GeocodeProvider { 38ccb4c318aa5150ba49b7e7878d20b4787d6bf723Laurent Tu 39ccb4c318aa5150ba49b7e7878d20b4787d6bf723Laurent Tu private IGeocodeProvider.Stub mProvider = new IGeocodeProvider.Stub() { 40ccb4c318aa5150ba49b7e7878d20b4787d6bf723Laurent Tu public String getFromLocation(double latitude, double longitude, int maxResults, 41ccb4c318aa5150ba49b7e7878d20b4787d6bf723Laurent Tu GeocoderParams params, List<Address> addrs) { 42ccb4c318aa5150ba49b7e7878d20b4787d6bf723Laurent Tu return GeocodeProvider.this.onGetFromLocation(latitude, longitude, maxResults, 43ccb4c318aa5150ba49b7e7878d20b4787d6bf723Laurent Tu params, addrs); 44ccb4c318aa5150ba49b7e7878d20b4787d6bf723Laurent Tu } 45ccb4c318aa5150ba49b7e7878d20b4787d6bf723Laurent Tu 46ccb4c318aa5150ba49b7e7878d20b4787d6bf723Laurent Tu public String getFromLocationName(String locationName, 47ccb4c318aa5150ba49b7e7878d20b4787d6bf723Laurent Tu double lowerLeftLatitude, double lowerLeftLongitude, 48ccb4c318aa5150ba49b7e7878d20b4787d6bf723Laurent Tu double upperRightLatitude, double upperRightLongitude, int maxResults, 49ccb4c318aa5150ba49b7e7878d20b4787d6bf723Laurent Tu GeocoderParams params, List<Address> addrs) { 50ccb4c318aa5150ba49b7e7878d20b4787d6bf723Laurent Tu return GeocodeProvider.this.onGetFromLocationName(locationName, lowerLeftLatitude, 51ccb4c318aa5150ba49b7e7878d20b4787d6bf723Laurent Tu lowerLeftLongitude, upperRightLatitude, upperRightLongitude, 52ccb4c318aa5150ba49b7e7878d20b4787d6bf723Laurent Tu maxResults, params, addrs); 53ccb4c318aa5150ba49b7e7878d20b4787d6bf723Laurent Tu } 54ccb4c318aa5150ba49b7e7878d20b4787d6bf723Laurent Tu }; 55ccb4c318aa5150ba49b7e7878d20b4787d6bf723Laurent Tu 56ccb4c318aa5150ba49b7e7878d20b4787d6bf723Laurent Tu /** 57ccb4c318aa5150ba49b7e7878d20b4787d6bf723Laurent Tu * This method is overridden to implement the 58ccb4c318aa5150ba49b7e7878d20b4787d6bf723Laurent Tu * {@link android.location.Geocoder#getFromLocation(double, double, int)} method. 59ccb4c318aa5150ba49b7e7878d20b4787d6bf723Laurent Tu * Classes implementing this method should not hold a reference to the params parameter. 60ccb4c318aa5150ba49b7e7878d20b4787d6bf723Laurent Tu */ 61ccb4c318aa5150ba49b7e7878d20b4787d6bf723Laurent Tu public abstract String onGetFromLocation(double latitude, double longitude, int maxResults, 62ccb4c318aa5150ba49b7e7878d20b4787d6bf723Laurent Tu GeocoderParams params, List<Address> addrs); 63ccb4c318aa5150ba49b7e7878d20b4787d6bf723Laurent Tu 64ccb4c318aa5150ba49b7e7878d20b4787d6bf723Laurent Tu /** 65ccb4c318aa5150ba49b7e7878d20b4787d6bf723Laurent Tu * This method is overridden to implement the 66ccb4c318aa5150ba49b7e7878d20b4787d6bf723Laurent Tu * {@link android.location.Geocoder#getFromLocationName(String, int, double, double, double, double)} method. 67ccb4c318aa5150ba49b7e7878d20b4787d6bf723Laurent Tu * Classes implementing this method should not hold a reference to the params parameter. 68ccb4c318aa5150ba49b7e7878d20b4787d6bf723Laurent Tu */ 69ccb4c318aa5150ba49b7e7878d20b4787d6bf723Laurent Tu public abstract String onGetFromLocationName(String locationName, 70ccb4c318aa5150ba49b7e7878d20b4787d6bf723Laurent Tu double lowerLeftLatitude, double lowerLeftLongitude, 71ccb4c318aa5150ba49b7e7878d20b4787d6bf723Laurent Tu double upperRightLatitude, double upperRightLongitude, int maxResults, 72ccb4c318aa5150ba49b7e7878d20b4787d6bf723Laurent Tu GeocoderParams params, List<Address> addrs); 73ccb4c318aa5150ba49b7e7878d20b4787d6bf723Laurent Tu 74ccb4c318aa5150ba49b7e7878d20b4787d6bf723Laurent Tu /** 75ccb4c318aa5150ba49b7e7878d20b4787d6bf723Laurent Tu * Returns the Binder interface for the geocode provider. 76ccb4c318aa5150ba49b7e7878d20b4787d6bf723Laurent Tu * This is intended to be used for the onBind() method of 77ccb4c318aa5150ba49b7e7878d20b4787d6bf723Laurent Tu * a service that implements a geocoder service. 78ccb4c318aa5150ba49b7e7878d20b4787d6bf723Laurent Tu * 79ccb4c318aa5150ba49b7e7878d20b4787d6bf723Laurent Tu * @return the IBinder instance for the provider 80ccb4c318aa5150ba49b7e7878d20b4787d6bf723Laurent Tu */ 81ccb4c318aa5150ba49b7e7878d20b4787d6bf723Laurent Tu public IBinder getBinder() { 82ccb4c318aa5150ba49b7e7878d20b4787d6bf723Laurent Tu return mProvider; 83ccb4c318aa5150ba49b7e7878d20b4787d6bf723Laurent Tu } 84ccb4c318aa5150ba49b7e7878d20b4787d6bf723Laurent Tu} 85