public static final class ContactsContract.CommonDataKinds.StructuredPostal extends Object implements ContactsContract.DataColumnsWithJoins, ContactsContract.CommonDataKinds.CommonColumns
A data kind representing a postal addresses.
You can use all columns defined for ContactsContract.Data
as
well as the following aliases.
Type | Alias | Data column | |
---|---|---|---|
String | FORMATTED_ADDRESS |
ContactsContract.DataColumns.DATA1 |
|
int | ContactsContract.CommonDataKinds.CommonColumns.TYPE |
ContactsContract.DataColumns.DATA2 |
Allowed values are:
|
String | ContactsContract.CommonDataKinds.CommonColumns.LABEL |
ContactsContract.DataColumns.DATA3 |
|
String | STREET |
ContactsContract.DataColumns.DATA4 |
|
String | POBOX |
ContactsContract.DataColumns.DATA5 |
Post Office Box number |
String | NEIGHBORHOOD |
ContactsContract.DataColumns.DATA6 |
|
String | CITY |
ContactsContract.DataColumns.DATA7 |
|
String | REGION |
ContactsContract.DataColumns.DATA8 |
|
String | POSTCODE |
ContactsContract.DataColumns.DATA9 |
|
String | COUNTRY |
ContactsContract.DataColumns.DATA10 |
Modifier and Type | Field and Description |
---|---|
static String |
CITY
Can be city, village, town, borough, etc.
|
static String |
CONTENT_ITEM_TYPE
MIME type used when storing this in data table.
|
static String |
CONTENT_TYPE
The MIME type of
CONTENT_URI providing a directory of
postal addresses. |
static Uri |
CONTENT_URI
The content:// style URI for all data records of the
CONTENT_ITEM_TYPE MIME type. |
static String |
COUNTRY
The name or code of the country.
|
static String |
EXTRA_ADDRESS_BOOK_INDEX
Add this query parameter to a URI to get back row counts grouped by the address book
index as cursor extras.
|
static String |
EXTRA_ADDRESS_BOOK_INDEX_COUNTS
The array of group counts for the corresponding group.
|
static String |
EXTRA_ADDRESS_BOOK_INDEX_TITLES
The array of address book index titles, which are returned in the
same order as the data in the cursor.
|
static String |
FORMATTED_ADDRESS
The full, unstructured postal address.
|
static String |
NEIGHBORHOOD
This is used to disambiguate a street address when a city
contains more than one street with the same name, or to specify a
small place whose mail is routed through a larger postal town.
|
static String |
POBOX
Covers actual P.O. boxes, drawers, locked bags, etc.
|
static String |
POSTCODE
Postal code.
|
static String |
REGION
A state, province, county (in Ireland), Land (in Germany),
departement (in France), etc.
|
static String |
STREET
Can be street, avenue, road, etc.
|
static int |
TYPE_HOME |
static int |
TYPE_OTHER |
static int |
TYPE_WORK |
_COUNT, _ID
CARRIER_PRESENCE, CARRIER_PRESENCE_VT_CAPABLE, DATA_VERSION, DATA1, DATA10, DATA11, DATA12, DATA13, DATA14, DATA15, DATA2, DATA3, DATA4, DATA5, DATA6, DATA7, DATA8, DATA9, HASH_ID, IS_PRIMARY, IS_READ_ONLY, IS_SUPER_PRIMARY, MIMETYPE, RAW_CONTACT_ID, RES_PACKAGE, SYNC1, SYNC2, SYNC3, SYNC4
AVAILABLE, AWAY, CAPABILITY_HAS_CAMERA, CAPABILITY_HAS_VIDEO, CAPABILITY_HAS_VOICE, CHAT_CAPABILITY, DO_NOT_DISTURB, IDLE, INVISIBLE, OFFLINE, PRESENCE, PRESENCE_CUSTOM_STATUS, PRESENCE_STATUS, STATUS, STATUS_ICON, STATUS_LABEL, STATUS_RES_PACKAGE, STATUS_TIMESTAMP
ACCOUNT_TYPE_AND_DATA_SET, AGGREGATION_MODE, BACKUP_ID, CONTACT_ID, DATA_SET, DELETED, METADATA_DIRTY, RAW_CONTACT_IS_READ_ONLY, RAW_CONTACT_IS_USER_PROFILE
CONTACT_LAST_UPDATED_TIMESTAMP, DISPLAY_NAME, HAS_PHONE_NUMBER, IN_DEFAULT_DIRECTORY, IN_VISIBLE_GROUP, IS_USER_PROFILE, LOOKUP_KEY, NAME_RAW_CONTACT_ID, PHOTO_FILE_ID, PHOTO_ID, PHOTO_THUMBNAIL_URI, PHOTO_URI
DISPLAY_NAME_ALTERNATIVE, DISPLAY_NAME_PRIMARY, DISPLAY_NAME_SOURCE, PHONETIC_NAME, PHONETIC_NAME_STYLE, SORT_KEY_ALTERNATIVE, SORT_KEY_PRIMARY
CUSTOM_RINGTONE, LAST_TIME_CONTACTED, PINNED, SEND_TO_VOICEMAIL, STARRED, TIMES_CONTACTED
CONTACT_CHAT_CAPABILITY, CONTACT_PRESENCE, CONTACT_STATUS, CONTACT_STATUS_ICON, CONTACT_STATUS_LABEL, CONTACT_STATUS_RES_PACKAGE, CONTACT_STATUS_TIMESTAMP
LAST_TIME_USED, TIMES_USED
DATA, LABEL, TYPE
TYPE_CUSTOM
Modifier and Type | Method and Description |
---|---|
static CharSequence |
getTypeLabel(Resources res,
int type,
CharSequence label)
Return a
CharSequence that best describes the given type,
possibly substituting the given ContactsContract.CommonDataKinds.CommonColumns.LABEL value
for ContactsContract.CommonDataKinds.BaseTypes.TYPE_CUSTOM . |
static int |
getTypeLabelResource(int type)
Return the string resource that best describes the given
ContactsContract.CommonDataKinds.CommonColumns.TYPE . |
public static final String CONTENT_ITEM_TYPE
public static final String CONTENT_TYPE
CONTENT_URI
providing a directory of
postal addresses.public static final Uri CONTENT_URI
CONTENT_ITEM_TYPE
MIME type.public static final int TYPE_HOME
public static final int TYPE_WORK
public static final int TYPE_OTHER
public static final String FORMATTED_ADDRESS
Type: TEXT
public static final String STREET
Type: TEXT
public static final String POBOX
Type: TEXT
public static final String NEIGHBORHOOD
Type: TEXT
public static final String CITY
Type: TEXT
public static final String REGION
Type: TEXT
public static final String POSTCODE
Type: TEXT
public static final String COUNTRY
Type: TEXT
public static final String EXTRA_ADDRESS_BOOK_INDEX
Example: import android.provider.ContactsContract.Contacts; Uri uri = Contacts.CONTENT_URI.buildUpon() .appendQueryParameter(Contacts.EXTRA_ADDRESS_BOOK_INDEX, "true") .build(); Cursor cursor = getContentResolver().query(uri, new String[] {Contacts.DISPLAY_NAME}, null, null, null); Bundle bundle = cursor.getExtras(); if (bundle.containsKey(Contacts.EXTRA_ADDRESS_BOOK_INDEX_TITLES) && bundle.containsKey(Contacts.EXTRA_ADDRESS_BOOK_INDEX_COUNTS)) { String sections[] = bundle.getStringArray(Contacts.EXTRA_ADDRESS_BOOK_INDEX_TITLES); int counts[] = bundle.getIntArray(Contacts.EXTRA_ADDRESS_BOOK_INDEX_COUNTS); }
public static final String EXTRA_ADDRESS_BOOK_INDEX_TITLES
TYPE: String[]
public static final String EXTRA_ADDRESS_BOOK_INDEX_COUNTS
TYPE: int[]
public static final int getTypeLabelResource(int type)
ContactsContract.CommonDataKinds.CommonColumns.TYPE
. Will always return a valid resource.public static final CharSequence getTypeLabel(Resources res, int type, CharSequence label)
CharSequence
that best describes the given type,
possibly substituting the given ContactsContract.CommonDataKinds.CommonColumns.LABEL
value
for ContactsContract.CommonDataKinds.BaseTypes.TYPE_CUSTOM
.