题记

自研的电话应用中，有两处使用了号码归属地，一处是通话记录页，一处是通话界面；那么它们是如何实现的呢？下面进行一步一步的分析。

Dialer使用号码归属地

通话记录页的号码归属地

通过查询calls表中的Calls.GEOCODED_LOCATION字段，来进行获取号码的归属地。

相关代码如下：

查询：

startQuery(token, null, uri, CallLogQuery._PROJECTION, selection, selectionArgs.toArray(

new String[selectionArgs.size()]), Calls.DEFAULT_SORT_ORDER);

获取号码归属地

details.geocode = c.getString(CallLogQuery.GEOCODED_LOCATION);

既然是通过查询数据库而得，那么数据是何时及如何更新的呢？

熟悉通话流程框架就会知道，添加一个通话需要经过APP->Telecom->framework->modem几层进行。那么通话记录的更新就是在Telecom的CallLogManager.java进行管理；

源码地址：packages/services/Telecomm/src/com/android/server/telecom/CallLogManager

主要流程是：onCallAdd->onCallStateChanged->logCall；logCall方法到最后就是向calls表中插入该通电话的各个信息；

该文只对location(号码归属地)进行详细分析。

查看logCall的实现：

logCall(call.getCallerInfo(), logNumber, call.getPostDialDigits(), formattedViaNumber,

call.getHandlePresentation(), callLogType, callFeatures, accountHandle,

creationTime, age, callDataUsage, call.isEmergencyCall(), call.getInitiatingUser(),

logCallCompletedListener,

call.getConferenceCallLogId() /* M: For Volte Conference call */);

发现位置等信息的是存储在call.getCallerInfo()中，那么call.getCallerInfo()得到的mCallerInfo，又是怎么获取到location(号码归属地)的呢？

查看CallerInfo类，发现updateGeoDescription方法就是为了获取号码归属地；代码如下：

public void updateGeoDescription(Context context, String fallbackNumber) {

String number = TextUtils.isEmpty(phoneNumber) ? fallbackNumber : phoneNumber;

geoDescription = getGeoDescription(context, number);

}

getGeoDescription方法实现如下：

需引用如下包：

import com.android.i18n.phonenumbers.geocoding.PhoneNumberOfflineGeocoder;

import com.android.i18n.phonenumbers.NumberParseException;

import com.android.i18n.phonenumbers.PhoneNumberUtil;

import com.android.i18n.phonenumbers.Phonenumber.PhoneNumber;

private static String getGeoDescription(Context context, String number) {

if (VDBG) Rlog.v(TAG, "getGeoDescription('" + number + "')...");

if (TextUtils.isEmpty(number)) {

return null;

}

// MTK新增逻辑，7.0以后geoCodingQuery实现为空，即已舍弃新增的逻辑实现。

/// M: CC: Query city name via GeoCodingQuery @{

// [ALPS00286530]Query Geocoding description

if (SystemProperties.get("ro.mtk_phone_number_geo").equals("1")) {

GeoCodingQuery geoCodingQuery = GeoCodingQuery.getInstance(context);

String cityName = geoCodingQuery.queryByNumber(number);

Rlog.v(TAG, "[GeoCodingQuery] cityName = " + cityName);

if ((cityName != null) && (!cityName.equals(""))) {

return cityName;

}

}

/// @}

PhoneNumberUtil util = PhoneNumberUtil.getInstance();

PhoneNumberOfflineGeocoder geocoder = PhoneNumberOfflineGeocoder.getInstance();

Locale locale = context.getResources().getConfiguration().locale;

String countryIso = getCurrentCountryIso(context, locale);

PhoneNumber pn = null;

try {

if (VDBG) Rlog.v(TAG, "parsing '" + number

+ "' for countryIso '" + countryIso + "'...");

pn = util.parse(number, countryIso);

if (VDBG) Rlog.v(TAG, "- parsed number: " + pn);

} catch (NumberParseException e) {

Rlog.d(TAG, "getGeoDescription: NumberParseException for incoming number '"

+ number + "'");

}

if (pn != null) {

String description = geocoder.getDescriptionForNumber(pn, locale);

if (VDBG) Rlog.v(TAG, "- got description: '" + description + "'");

return description;

} else {

return null;

}

}

通过getGeoDescription的实现我们可以知道获取号码归属地的核心为：

//获取PhoneNumberUtil、PhoneNumberOfflineGeocoder 实例

PhoneNumberUtil util = PhoneNumberUtil.getInstance();

PhoneNumberOfflineGeocoder geocoder = PhoneNumberOfflineGeocoder.getInstance();

//获取国家码，此处会转换为two letters country code，如(86等)

Locale locale = context.getResources().getConfiguration().locale;

String countryIso = getCurrentCountryIso(context, locale);

//libphonenumber库中定义的号码“结构”，包含国家码和号码

PhoneNumber pn = null;

try {

if (VDBG) Rlog.v(TAG, "parsing '" + number

+ "' for countryIso '" + countryIso + "'...");

pn = util.parse(number, countryIso);

if (VDBG) Rlog.v(TAG, "- parsed number: " + pn);

} catch (NumberParseException e) {

Rlog.d(TAG, "getGeoDescription: NumberParseException for incoming number '"

+ number + "'");

}

if (pn != null) {

//真正解析，筛选的方法

String description = geocoder.getDescriptionForNumber(pn, locale);

if (VDBG) Rlog.v(TAG, "- got description: '" + description + "'");

return description;

} else {

return null;

}

总结就是使用phonenumbers的方法进行实现。

通话界面中的号码归属地

使用phonenumbers的方法直接对号码进行处理得到号码归属地：

通话界面调用代码：

String location=GeoUtil.getGeocodedLocationFor(getActivity(), number);

GeoUtil是ContactCommon的一个类，实现如下

import com.google.i18n.phonenumbers.geocoding.PhoneNumberOfflineGeocoder;

import com.google.i18n.phonenumbers.NumberParseException;

import com.google.i18n.phonenumbers.PhoneNumberUtil;

import com.google.i18n.phonenumbers.Phonenumber;

import java.util.Locale;

/** * Static methods related to Geo. */

public class GeoUtil {

/** * Returns the country code of the country the user is currently in. Before calling this * method, make sure that {@link CountryDetector#initialize(Context)} has already been called * in {@link Application#onCreate()}. *@return The ISO 3166-1 two letters country code of the country the user * is in. */

public static String getCurrentCountryIso(Context context) {

// The {@link CountryDetector} should never return null so this is safe to return as-is.

return CountryDetector.getInstance(context).getCurrentCountryIso();

}

public static String getGeocodedLocationFor(Context context, String phoneNumber) {

final PhoneNumberOfflineGeocoder geocoder = PhoneNumberOfflineGeocoder.getInstance();

final PhoneNumberUtil phoneNumberUtil = PhoneNumberUtil.getInstance();

try {

final Phonenumber.PhoneNumber structuredPhoneNumber =

phoneNumberUtil.parse(phoneNumber, getCurrentCountryIso(context));

final Locale locale = context.getResources().getConfiguration().locale;

return geocoder.getDescriptionForNumber(structuredPhoneNumber, locale);

} catch (NumberParseException e) {

return null;

}

}

}

我们发现也是使用geocoder.getDescriptionForNumber(structuredPhoneNumber, locale)进行获取号码归属地。

总结

号码归属地使用com.google.i18n.phonenumbers下的方法进行获取：核心代码如下：

final PhoneNumberOfflineGeocoder geocoder = PhoneNumberOfflineGeocoder.getInstance();

final PhoneNumberUtil phoneNumberUtil = PhoneNumberUtil.getInstance();

try {

final Phonenumber.PhoneNumber structuredPhoneNumber =

phoneNumberUtil.parse(phoneNumber, getCurrentCountryIso(context));

final Locale locale = context.getResources().getConfiguration().locale;

return geocoder.getDescriptionForNumber(structuredPhoneNumber, locale);

} catch (NumberParseException e) {

return null;

}

Libphonenumber -号码归属地核心

分析了电话应用两处使用号码归属地的实现发现号码归属地是使用google源码自带的库-Libphonenumber。这里就大致介绍下这个库的原理

源码地址：external/libphonenumber/

号码归属地主要是使用如下地址的代码：

external/libphonenumber/libphonenumber/src/com/google/i18n/phonenumbers

主要涉及：PhoneNumberOfflineGeocoder、PhoneNumberUtil、MetadataLoader、prefixFileReader、