Changes

'''*NOTE:''' In order to test this feature the newest version of the simulator must be installed<br/>10.1. In order to implement Address Locator we need to add address field and getter/setter methods to <code>Student</code> class: <source lang="java"> public Student(String firstName, String lastName, String email, String address) { this.firstName = firstName; this.lastName = lastName; this.email = email; this.email = address; //add address field }  public String getAddress(){ return address; } public void setAddress(String address){ this.address = address; } </source>10.2. Add EditTextFields to Add, Edit and view option:<br/>viewItem <source lang="java"> BasicEditField addressField = new BasicEditField("address: ",student.getAddress(),50,Field.NON_FOCUSABLE); addressField.setBorder(roundedBorder); addressField.setBackground(solidBackground); add(addressField); </source>addItem <source lang="java"> EditField inputField4 = new EditField("Student's address: ",""); addDialog.add(inputField4);  // Display the dialog and add a new element to the list if(addDialog.doModal() == 0) { addElementToList(new Student(inputField1.getText(),inputField2.getText(),inputField3.getText(), inputField4.getText())); } </source>editItem <source lang="java"> EditField inputField4 = new EditField("Address: ",studentOld.getAddress()); editDialog.add(inputField4);  if(editDialog.doModal() == 0) { studentNew.setFirstName(inputField1.getText()); studentNew.setLastName(inputField2.getText()); studentNew.setEmail(inputField3.getText()); studentNew.setAddress(inputField4.getText()); //set Address editListElement(studentOld, studentNew); } </source>10.3. Add the Map Option to the manu:<br/>

10.24. Implement address locator:

if(student != null) { try { String address = student.getAddress(); //start coordinates Coordinates co = new Coordinates(45.423488, -75.697929, 0); Landmark[] landm = Locator.geocode(address, co); //Get latitude and longitude double lon = landm[0].getQualifiedCoordinates().getLongitude()*100000.0 ; double lat = landm[0].getQualifiedCoordinates().getLatitude()*100000.0; //create XML document StringBuffer document = new StringBuffer("<location-document><location lon='"); document.append(lon).append("' lat='").append(lat).append("' label='").append showAddress(address); document.append("' description='Student Address' zoom='10'/></location-document>"); // Invoke maps application for current Contact Invoke.invokeApplication(Invoke.APP_TYPE_MAPS, new MapsArguments(MapsArguments.ARG_LOCATION_DOCUMENT, document.toString())); } catch(LocatorException ex){ Dialog.alert("cannot get location: " + ex.getMessage()); } catch(Exception ex){ Dialog.alert("map application is not available: "+ ex.getMessage()); } }

})); </source>10.5. Implement <code>showAddress()</code> method. The <code>Locator.geocode()</code?> method must be in another thread: <source lang="java"> public void showAddress(String adrs)throws LocatorException{ final String address = adrs; new Thread(new Runnable(){ public void run(){ try { Landmark[] landm = Locator.geocode(address, null); MapsArguments ma = new MapsArguments(landm); Invoke.invokeApplication(Invoke.APP_TYPE_MAPS, ma); } catch (Exception ex) { Dialog.alert("Exception when getting location: " + ex.getMessage()); } } }).start(); }