ContactAddress

Contiene propiedades de una de las direcciones de este contacto (Contact).

Propiedades

pref: true si este ContactAddress es preferido. (boolean)
type: Una string que te dice que tipo de dirección es esta (Ejemplo: ‘Home’). _(DOMString)
formatted: Toda la dirección formateada para mostrarla. (DOMString)
streetAddress: La dirección de calle completa. (DOMString)
locality: La ciudad o localidad. (DOMString)
region: El estado o region. (DOMString)
postalCode: Código postal o zip. (DOMString)
country: Nombre del país. (DOMString)

Detalles

El objeto ContactAddress almacena propiedades de un sola dirección del contacto. Un objeto Contact puede tener una o mas direcciones en el array ContactAddress[]

Plataformas Soportadas

Android
BlackBerry WebWorks (OS 5.0 y superior)
iOS

Ejemplo Rápido

// Muestra información sobre la dirección de todos los contactos
function onSuccess(contacts) {
	for (var i=0; i<contacts.length; i++) {
		for (var j=0; j<contacts[i].addresses.length; j++) {
			alert("Preferente: " + contacts[i].addresses[j].pref + "\n" +
					"Tipo: " + contacts[i].addresses[j].type + "\n" +
					"Formateada: " + contacts[i].addresses[j].formatted + "\n" + 
					"Dirección: "  + contacts[i].addresses[j].streetAddress + "\n" + 
					"Localidad: "  + contacts[i].addresses[j].locality + "\n" + 
					"Provincia: "  + contacts[i].addresses[j].region + "\n" + 
					"Código Postal: "  + contacts[i].addresses[j].postalCode + "\n" + 
					"País: "  + contacts[i].addresses[j].country);
		}
	}
};

function onError(contactError) {
    alert('onError!');
};

// Busca todos los contactos
var options = new ContactFindOptions();
options.filter=""; 
var filter = ["displayName","addresses"];
navigator.contacts.find(filter, onSuccess, onError, options);

Ejemplo Completo

<!DOCTYPE html>
<html>
  <head>
    <title>Ejemplo de Contacts</title>

    <script type="text/javascript" charset="utf-8" src="phonegap.js"></script>
    <script type="text/javascript" charset="utf-8">

    // Espera a que PhoneGap se inicie
    //
    document.addEventListener("deviceready", onDeviceReady, false);

    // PhoneGap esta listo
    //
    function onDeviceReady() {
	    // Busca todos los contactos
	    var options = new ContactFindOptions();
		options.filter=""; 
		var filter = ["displayName","addresses"];
	    navigator.contacts.find(filter, onSuccess, onError, options);
    }

    // onSuccess: Obtiene el resultado
    //
	function onSuccess(contacts) {
		// muestra la información de dirección de todos los contactos
		for (var i=0; i<contacts.length; i++) {
			for (var j=0; j<contacts[i].addresses.length; j++) {
				alert("Preferente: " + contacts[i].addresses[j].pref + "\n" +
						"Tipo: " + contacts[i].addresses[j].type + "\n" +
						"Formateada: " + contacts[i].addresses[j].formatted + "\n" + 
						"Dirección: "  + contacts[i].addresses[j].streetAddress + "\n" + 
						"Localidad: "  + contacts[i].addresses[j].locality + "\n" + 
						"Provincia: "  + contacts[i].addresses[j].region + "\n" + 
						"Código Postal: "  + contacts[i].addresses[j].postalCode + "\n" + 
						"País: "  + contacts[i].addresses[j].country);
			}
		}
	};

    // onError: Ocurrió un error
    //
    function onError(contactError) {
        alert('onError!');
    }

    </script>
  </head>
  <body>
    <h1>Ejemplo</h1>
    <p>Búsqueda de Contactos</p>
  </body>
</html>

Peculiaridades Android 2.X

pref: Esta propiedad no esta soportada por dispositivos Android 2.X, y siempre retornaran false.

Peculiaridades Android 1.X

pref: Esta propiedad no esta soportada por dispositivos Android 1.X, y siempre retornara false.
type: Esta propiedad no esta soportada por dispositivos Android 1.X, y siempre retornara null.
streetAddress: Esta propiedad no esta soportada por dispositivos Android 1.X, y siempre retornara null.
locality: Esta propiedad no esta soportada por dispositivos Android 1.X, y siempre retornara null.
region: Esta propiedad no esta soportada por dispositivos Android 1.X, y siempre retornara null.
postalCode: Esta propiedad no esta soportada por dispositivos Android 1.X, y siempre retornara null.
country: Esta propiedad no esta soportada por dispositivos Android 1.X, y siempre retornara null.

Peculiaridades BlackBerry WebWorks (OS 5.0 y superior)

pref: Esta propiedad no esta soportada por dispositivos BlackBerry, y siempre retornara false.
type: Soportada parcialmente. Solo permite un “Work” y un “Home” por cada contacto.
formatted: Soportada parcialmente. Retornara una concatenación de todos los campos de la dirección.
streetAddress: Soportada. Retornara los campos concatenados address1 y address2.
locality: Soportada. Almacenada en el campo city.
region: Soportada. Almacenada en el campo stateProvince.
postalCode: Soportada. Almacenada en el campo zipPostal.
country: Soportada.

Peculiaridades iOS

pref: Esta propiedad no esta soportada por dispositivos iOS, y siempre retornara false.
formatted: Actualmente no esta soportado.