PhoneNumber Android Library

The default query order is: Local Special Numbers $\rightarrow$ Local Common Numbers $\rightarrow$ Local Marked Numbers $\rightarrow$ Local Offline Location $\rightarrow$ Google Offline Location $\rightarrow$ Online Custom API $\rightarrow$ Online Baidu API $\rightarrow$ Online Juhe (360) API.

You can control which online interface is prioritized by setting the api_type key in SharedPreferences. The value should correspond to the getApiId() return value of the specific module.

To enable online querying via Baidu or Juhe (360) APIs, you must add the corresponding API keys as meta-data in your AndroidManifest.xml.

• org.xdty.phone.number.API_KEY: Obtain from the Baidu API Center.
• org.xdty.phone.JUHE_API_KEY: Obtain from Juhe Data (360).

<meta-data
    android:name="org.xdty.phone.number.API_KEY"
    android:value="API_KEY"/>
<meta-data
    android:name="org.xdty.phone.JUHE_API_KEY"
    android:value="JUHE_API_KEY"/>

To use the library, you must provide an API key in your AndroidManifest.xml using the org.xdty.phone.number.API_KEY meta-data tag. You can obtain an API key from the Baidu apistore's usercenter.

<meta-data
    android:name="org.xdty.phone.number.API_KEY"
    android:value="YOUR_API_KEY"/>

If you want to prevent the library from making network requests, you can disable online querying in two ways:

1. Globally: Set the only_offline_key key in SharedPreferences.
2. Temporarily: Use the PhoneNumber constructor that accepts a boolean flag: PhoneNumber(context, true, callback).

You can integrate the PhoneNumber library into your Android project using Gradle or Maven. Note that the version specified in the examples is 0.6.11.

### Gradle
```groovy
dependencies {
    compile 'org.xdty.phone.number:phone-number:0.6.11'
}

Maven

<dependency>
  <groupId>org.xdty.phone.number</groupId>
  <artifactId>phone-number</artifactId>
  <version>0.6.11</version>
  <type>aar</type>
</dependency>

To retrieve geolocation and other information for a phone number, instantiate PhoneNumber with a context and a PhoneNumber.Callback. Use the .fetch() method to initiate the request.

Inside the onResponse(INumber number) callback, you can access information from the INumber object, such as number.getName().

new PhoneNumber(this, new PhoneNumber.Callback() {
    @Override
    public void onResponse(INumber number) {
        // Do your jobs here
        textView.setText(number.getName());
    }

    @Override
    public void onResponseFailed(INumber number) {
    }
}).fetch("10086", "10000", "10001", "OTHER_PHONE_NUMBER");

To use WebNumberHandler, you must provide a WebConfig instance. The handler relies on this configuration to perform web scraping via Jsoup. The following configuration keys are used by the handler:

• url: The base URL used for requests (e.g., https://example.com/search/).
• ua: The User-Agent string for the HTTP request.
• index: An integer used to calculate the API ID via INumber.API_ID_WEB + index.
• root: CSS selector for the main content container.
• number: CSS selector to extract the phone number.
• mark: CSS selector to extract the mark/name.
• count: CSS selector to extract the numeric count.
• name: CSS selector to extract the name.
• address: CSS selector to extract the province/address.

Note: If multiple selectors (like mark and name) are provided, the last one successfully matched will determine the WebNumber.setName() value.

The WebNumberHandler is a NumberHandler implementation used to fetch phone number information from a web source by scraping HTML content. It requires a WebConfig object to define how to connect to the URL and which CSS selectors to use for extracting data.

When find(n: String) is called, the handler performs the following steps:

1. Connects to ${WebConfig.url}${n} using the configured User-Agent.
2. Uses CSS selectors defined in WebConfig to extract:
   • number: The phone number text.
   • mark: The name/mark of the number.
   • count: A numeric count (cleaned of non-digit characters).
   • name: The name associated with the number.
   • address: The province/address information.
3. Returns a WebNumber object populated with the extracted data.