Android APIs
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

Class Overview

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 CONTENT_URI or 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.
[Expand]
Inherited Constants
From interface android.provider.BaseColumns
From interface android.provider.ContactsContract.ContactsColumns
From interface android.provider.ContactsContract.ContactOptionsColumns
From interface android.provider.ContactsContract.ContactStatusColumns
[Expand]
Inherited Methods
From class java.lang.Object

Constants

public static final String CONTENT_DIRECTORY

Added in API level 5

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

Constant Value: "suggestions"