ContactsContract.Contacts.AggregationSuggestions


public static final class ContactsContract.Contacts.AggregationSuggestions
extends Object implements BaseColumns, ContactsContract.ContactsColumns, ContactsContract.ContactOptionsColumns, ContactsContract.ContactStatusColumns

java.lang.Object
   ↳ android.provider.ContactsContract.Contacts.AggregationSuggestions


A read-only sub-directory of a single contact aggregate that contains all aggregation suggestions (other contacts). The aggregation suggestions are computed based on approximate data matches with this contact.

Note: this query may be expensive! If you need to use it in bulk, make sure the user experience is acceptable when the query runs for a long time.

Usage example:

 Uri uri = Contacts.CONTENT_URI.buildUpon()
          .appendEncodedPath(String.valueOf(contactId))
          .appendPath(Contacts.AggregationSuggestions.CONTENT_DIRECTORY)
          .appendQueryParameter("limit", "3")
          .build()
 Cursor cursor = getContentResolver().query(suggestionsUri,
          new String[] {Contacts.DISPLAY_NAME, Contacts._ID, Contacts.LOOKUP_KEY},
          null, null, null);
 

This directory can be used either with a ContactsContract.Contacts.CONTENT_URI or ContactsContract.Contacts.CONTENT_LOOKUP_URI.

Summary

Nested classes

class ContactsContract.Contacts.AggregationSuggestions.Builder

A convenience builder for aggregation suggestion content URIs. 

Constants

String CONTENT_DIRECTORY

The directory twig for this sub-table.

Inherited constants

Inherited methods

Constants

CONTENT_DIRECTORY

Added in API level 5
public static final String CONTENT_DIRECTORY

The directory twig for this sub-table. The URI can be followed by an optional type-to-filter, similar to ContactsContract.Contacts.CONTENT_FILTER_URI.

Constant Value: "suggestions"