Location (OpenMRS 1.9.13-SNAPSHOT API)

java.lang.Object
- org.openmrs.BaseOpenmrsObject
- - org.openmrs.BaseOpenmrsMetadata
  - - org.openmrs.BaseCustomizableMetadata<LocationAttribute>
    - - org.openmrs.Location

All Implemented Interfaces:

java.io.Serializable, Address, Attributable<Location>, Auditable, Customizable<LocationAttribute>, OpenmrsMetadata, OpenmrsObject, Retireable
```
public class Location
extends BaseCustomizableMetadata<LocationAttribute>
implements java.io.Serializable, Attributable<Location>, Address
```
A Location is a physical place, such as a hospital, a room, a clinic, or a district. Locations support a single hierarchy, such that each location may have one parent location. A non-geographical grouping of locations, such as "All Community Health Centers" is not a location, and should be modeled using LocationTags. Note: Prior to version 1.9 this class extended BaseMetadata

See Also:

Serialized Form

Field Summary

Fields
Modifier and Type Field and Description

static int LOCATION_UNKNOWN

static long serialVersionUID

Fields
Modifier and Type	Field and Description
`static int`	`LOCATION_UNKNOWN`
`static long`	`serialVersionUID`

Constructor Summary

Constructors
Constructor and Description

Location()
default constructor

Location(java.lang.Integer locationId)
constructor with id

Constructors
Constructor and Description
`Location()` default constructor
`Location(java.lang.Integer locationId)` constructor with id

Method Summary

All Methods Static Methods Instance Methods Concrete Methods Deprecated Methods
Modifier and Type	Method and Description
`void`	`addChildLocation(Location child)`
`void`	`addTag(LocationTag tag)` Attaches a tag to the Location.
`java.util.List<Location>`	`findPossibleValues(java.lang.String searchText)` Search for possible values of this object using the given search string
`java.lang.String`	`getAddress1()`
`java.lang.String`	`getAddress2()`
`java.lang.String`	`getAddress3()`
`java.lang.String`	`getAddress4()`
`java.lang.String`	`getAddress5()`
`java.lang.String`	`getAddress6()`
`java.util.Set<Location>`	`getChildLocations()`
`java.util.Set<Location>`	`getChildLocations(boolean includeRetired)` Returns all childLocations where child.locationId = this.locationId.
`java.lang.String`	`getCityVillage()`
`java.lang.String`	`getCountry()`
`java.lang.String`	`getCountyDistrict()`
`java.lang.String`	`getDisplayString()` Gets a descriptive String used for display purposes This is meant as an alternative to using the toString() to display this object to a user
`java.lang.Integer`	`getId()`
`java.lang.String`	`getLatitude()`
`java.lang.Integer`	`getLocationId()`
`java.lang.String`	`getLongitude()`
`java.lang.String`	`getNeighborhoodCell()` Deprecated. As of 1.8, replaced by `getAddress3()`
`Location`	`getParentLocation()`
`java.util.List<Location>`	`getPossibleValues()` Find all possible values of this object.
`java.lang.String`	`getPostalCode()`
`java.lang.String`	`getRegion()` Deprecated. As of 1.8, replaced by `getAddress6()`
`java.lang.String`	`getStateProvince()`
`java.lang.String`	`getSubregion()` Deprecated. As of 1.8, replaced by `getAddress5()`
`java.util.Set<LocationTag>`	`getTags()`
`java.lang.String`	`getTownshipDivision()` Deprecated. As of 1.8, replaced by `getAddress4()`
`java.lang.Boolean`	`hasTag(java.lang.String tagToFind)` Checks whether the Location has a particular tag.
`Location`	`hydrate(java.lang.String locationId)` Deserialize the given string into a full object
`static java.lang.Boolean`	`isInHierarchy(Location location, Location root)` Checks whether 'location' is a member of the tree starting at 'root'.
`void`	`removeChildLocation(Location child)`
`void`	`removeTag(LocationTag tag)` Remove the tag from the Location.
`java.lang.String`	`serialize()` Turn the current object into an identifying string that can be retrieved later
`void`	`setAddress1(java.lang.String address1)`
`void`	`setAddress2(java.lang.String address2)`
`void`	`setAddress3(java.lang.String address3)`
`void`	`setAddress4(java.lang.String address4)`
`void`	`setAddress5(java.lang.String address5)`
`void`	`setAddress6(java.lang.String address6)`
`void`	`setChildLocations(java.util.Set<Location> childLocations)`
`void`	`setCityVillage(java.lang.String cityVillage)`
`void`	`setCountry(java.lang.String country)`
`void`	`setCountyDistrict(java.lang.String countyDistrict)`
`void`	`setId(java.lang.Integer id)`
`void`	`setLatitude(java.lang.String latitude)`
`void`	`setLocationId(java.lang.Integer locationId)`
`void`	`setLongitude(java.lang.String longitude)`
`void`	`setNeighborhoodCell(java.lang.String address3)` Deprecated. As of 1.8, replaced by `setAddress3(String)`
`void`	`setParentLocation(Location parentLocationId)`
`void`	`setPostalCode(java.lang.String postalCode)`
`void`	`setRegion(java.lang.String address6)` Deprecated. As of 1.8, replaced by `setAddress6(String)`
`void`	`setStateProvince(java.lang.String stateProvince)`
`void`	`setSubregion(java.lang.String address5)` Deprecated. As of 1.8, replaced by `setAddress5(String)`
`void`	`setTags(java.util.Set<LocationTag> tags)` Set the tags which are attached to this Location.
`void`	`setTownshipDivision(java.lang.String address4)` Deprecated. As of 1.8, replaced by `setAddress4(String)`
`java.lang.String`	`toString()` Returns a string consisting of the name of the class of which the object is an instance and the `uuid` field surrounded by `[` and `]`.

Methods inherited from class org.openmrs.BaseCustomizableMetadata
addAttribute, getActiveAttributes, getActiveAttributes, getAttributes, setAttribute, setAttributes

Methods inherited from class org.openmrs.BaseOpenmrsMetadata
getChangedBy, getCreator, getDateChanged, getDateCreated, getDateRetired, getDescription, getName, getRetired, getRetiredBy, getRetireReason, isRetired, setChangedBy, setCreator, setDateChanged, setDateCreated, setDateRetired, setDescription, setName, setRetired, setRetiredBy, setRetireReason

Methods inherited from class org.openmrs.BaseOpenmrsObject
equals, getUuid, hashCode, setUuid

Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.openmrs.OpenmrsObject
getUuid, setUuid

- Field Detail
  - serialVersionUID
```
public static final long serialVersionUID
```
    See Also:
    
    Constant Field Values
  - LOCATION_UNKNOWN
```
public static final int LOCATION_UNKNOWN
```
    See Also:
    
    Constant Field Values
- Constructor Detail
  - Location
```
public Location()
```
    default constructor
  - Location
```
public Location(java.lang.Integer locationId)
```
    constructor with id
- Method Detail
  - getAddress1
```
public java.lang.String getAddress1()
```
    Specified by:
    
    getAddress1 in interface Address
    
    Returns:
    
    Returns the address1.
  - setAddress1
```
public void setAddress1(java.lang.String address1)
```
    Specified by:
    
    setAddress1 in interface Address
    
    Parameters:
    
    address1 - The address1 to set.
  - getAddress2
```
public java.lang.String getAddress2()
```
    Specified by:
    
    getAddress2 in interface Address
    
    Returns:
    
    Returns the address2.
  - setAddress2
```
public void setAddress2(java.lang.String address2)
```
    Specified by:
    
    setAddress2 in interface Address
    
    Parameters:
    
    address2 - The address2 to set.
  - getCityVillage
```
public java.lang.String getCityVillage()
```
    Specified by:
    
    getCityVillage in interface Address
    
    Returns:
    
    Returns the cityVillage.
  - setCityVillage
```
public void setCityVillage(java.lang.String cityVillage)
```
    Specified by:
    
    setCityVillage in interface Address
    
    Parameters:
    
    cityVillage - The cityVillage to set.
  - getCountry
```
public java.lang.String getCountry()
```
    Specified by:
    
    getCountry in interface Address
    
    Returns:
    
    Returns the country.
  - setCountry
```
public void setCountry(java.lang.String country)
```
    Specified by:
    
    setCountry in interface Address
    
    Parameters:
    
    country - The country to set.
  - getLatitude
```
public java.lang.String getLatitude()
```
    Specified by:
    
    getLatitude in interface Address
    
    Returns:
    
    Returns the latitude.
  - setLatitude
```
public void setLatitude(java.lang.String latitude)
```
    Specified by:
    
    setLatitude in interface Address
    
    Parameters:
    
    latitude - The latitude to set.
  - getLocationId
```
public java.lang.Integer getLocationId()
```
    Returns:
    
    Returns the locationId.
  - setLocationId
```
public void setLocationId(java.lang.Integer locationId)
```
    Parameters:
    
    locationId - The locationId to set.
  - getLongitude
```
public java.lang.String getLongitude()
```
    Specified by:
    
    getLongitude in interface Address
    
    Returns:
    
    Returns the longitude.
  - setLongitude
```
public void setLongitude(java.lang.String longitude)
```
    Specified by:
    
    setLongitude in interface Address
    
    Parameters:
    
    longitude - The longitude to set.
  - getPostalCode
```
public java.lang.String getPostalCode()
```
    Specified by:
    
    getPostalCode in interface Address
    
    Returns:
    
    Returns the postalCode.
  - setPostalCode
```
public void setPostalCode(java.lang.String postalCode)
```
    Specified by:
    
    setPostalCode in interface Address
    
    Parameters:
    
    postalCode - The postalCode to set.
  - getStateProvince
```
public java.lang.String getStateProvince()
```
    Specified by:
    
    getStateProvince in interface Address
    
    Returns:
    
    Returns the stateProvince.
  - setStateProvince
```
public void setStateProvince(java.lang.String stateProvince)
```
    Specified by:
    
    setStateProvince in interface Address
    
    Parameters:
    
    stateProvince - The stateProvince to set.
  - toString
```
public java.lang.String toString()
```
    Description copied from class: BaseOpenmrsObject
    Returns a string consisting of the name of the class of which the object is an instance and the uuid field surrounded by [ and ]. In other words, this method returns a string equal to the value of:
    getClass().getName() + '[' + uuid + ']'
    If the uuid field is null, it delegates to Object.toString()
    Overrides:
    
    toString in class BaseOpenmrsObject
    
    See Also:
    
    Object.toString()
  - getCountyDistrict
```
public java.lang.String getCountyDistrict()
```
    Specified by:
    
    getCountyDistrict in interface Address
    
    Returns:
    
    Returns the countyDistrict.
  - setCountyDistrict
```
public void setCountyDistrict(java.lang.String countyDistrict)
```
    Specified by:
    
    setCountyDistrict in interface Address
    
    Parameters:
    
    countyDistrict - The countyDistrict to set.
  - getNeighborhoodCell
```
@Deprecated
public java.lang.String getNeighborhoodCell()
```
    Deprecated. As of 1.8, replaced by getAddress3()
    
    Returns:
    
    Returns the neighborhoodCell.
  - setNeighborhoodCell
```
@Deprecated
public void setNeighborhoodCell(java.lang.String address3)
```
    Deprecated. As of 1.8, replaced by setAddress3(String)
    
    Parameters:
    
    address3 - The neighborhoodCell to set.
  - findPossibleValues
```
public java.util.List<Location> findPossibleValues(java.lang.String searchText)
```
    Description copied from interface: Attributable
    
    Search for possible values of this object using the given search string
    
    Specified by:
    
    findPossibleValues in interface Attributable<Location>
    
    Parameters:
    
    searchText - String to search on
    
    Returns:
    
    List of possible objects that can be assigned
    
    See Also:
    
    Attributable.findPossibleValues(java.lang.String)
  - getPossibleValues
```
public java.util.List<Location> getPossibleValues()
```
    Description copied from interface: Attributable
    
    Find all possible values of this object. For example, if this object is a Location, the database is delved into and all Location objects should be returned
    
    Specified by:
    
    getPossibleValues in interface Attributable<Location>
    
    Returns:
    
    List of objects that can be assigned
    
    See Also:
    
    Attributable.getPossibleValues()
  - hydrate
```
public Location hydrate(java.lang.String locationId)
```
    Description copied from interface: Attributable
    
    Deserialize the given string into a full object
    
    Specified by:
    
    hydrate in interface Attributable<Location>
    
    Parameters:
    
    locationId - String to deserialize
    
    Returns:
    
    hydrated object
    
    See Also:
    
    Attributable.hydrate(java.lang.String)
  - serialize
```
public java.lang.String serialize()
```
    Description copied from interface: Attributable
    
    Turn the current object into an identifying string that can be retrieved later
    
    Specified by:
    
    serialize in interface Attributable<Location>
    
    Returns:
    
    String representing this object (Usually an identifier or primary key)
    
    See Also:
    
    Attributable.serialize()
  - getDisplayString
```
public java.lang.String getDisplayString()
```
    Description copied from interface: Attributable
    
    Gets a descriptive String used for display purposes This is meant as an alternative to using the toString() to display this object to a user
    
    Specified by:
    
    getDisplayString in interface Attributable<Location>
    
    Returns:
    
    String acceptable to display on a page
    
    See Also:
    
    Attributable.getDisplayString()
  - getRegion
```
@Deprecated
public java.lang.String getRegion()
```
    Deprecated. As of 1.8, replaced by getAddress6()
    
    Returns:
    
    the region
  - setRegion
```
@Deprecated
public void setRegion(java.lang.String address6)
```
    Deprecated. As of 1.8, replaced by setAddress6(String)
    
    Parameters:
    
    address6 - the region to set
  - getSubregion
```
@Deprecated
public java.lang.String getSubregion()
```
    Deprecated. As of 1.8, replaced by getAddress5()
    
    Returns:
    
    the subregion
  - setSubregion
```
@Deprecated
public void setSubregion(java.lang.String address5)
```
    Deprecated. As of 1.8, replaced by setAddress5(String)
    
    Parameters:
    
    address5 - the subregion to set
  - getTownshipDivision
```
@Deprecated
public java.lang.String getTownshipDivision()
```
    Deprecated. As of 1.8, replaced by getAddress4()
    
    Returns:
    
    the townshipDivision
  - setTownshipDivision
```
@Deprecated
public void setTownshipDivision(java.lang.String address4)
```
    Deprecated. As of 1.8, replaced by setAddress4(String)
    
    Parameters:
    
    address4 - the townshipDivision to set
  - getParentLocation
```
public Location getParentLocation()
```
    Returns:
    
    Returns the parentLocation.
    
    Since:
    
    1.5
  - setParentLocation
```
public void setParentLocation(Location parentLocationId)
```
    Parameters:
    
    parentLocationId - The parentLocation to set.
    
    Since:
    
    1.5
  - getChildLocations
```
public java.util.Set<Location> getChildLocations()
```
    Returns:
    
    Returns the childLocations.
    
    Since:
    
    1.5
  - getChildLocations
```
public java.util.Set<Location> getChildLocations(boolean includeRetired)
```
    Returns all childLocations where child.locationId = this.locationId.
    
    Parameters:
    
    includeRetired - specifies whether or not to include voided childLocations
    
    Returns:
    
    Returns a Set of all the childLocations.
    
    Since:
    
    1.5
  - setChildLocations
```
public void setChildLocations(java.util.Set<Location> childLocations)
```
    Parameters:
    
    childLocations - The childLocations to set.
    
    Since:
    
    1.5
  - addChildLocation
```
public void addChildLocation(Location child)
```
    Parameters:
    
    child - The child location to add.
    
    Since:
    
    1.5
  - isInHierarchy
```
public static java.lang.Boolean isInHierarchy(Location location,
                                              Location root)
```
    Checks whether 'location' is a member of the tree starting at 'root'.
    
    Parameters:
    
    location - The location to be tested.
    
    root - Location node from which to start the testing (down in the hierarchy).
    
    Since:
    
    1.5
  - removeChildLocation
```
public void removeChildLocation(Location child)
```
    Parameters:
    
    child - The child location to remove.
    
    Since:
    
    1.5
  - getTags
```
public java.util.Set<LocationTag> getTags()
```
    Returns:
    
    Returns the tags which have been attached to this Location.
    
    Since:
    
    1.5
  - setTags
```
public void setTags(java.util.Set<LocationTag> tags)
```
    Set the tags which are attached to this Location.
    
    Parameters:
    
    tags - The tags to set.
    
    Since:
    
    1.5
  - addTag
```
public void addTag(LocationTag tag)
```
    Attaches a tag to the Location.
    
    Parameters:
    
    tag - The tag to add.
    
    Since:
    
    1.5
  - removeTag
```
public void removeTag(LocationTag tag)
```
    Remove the tag from the Location.
    
    Parameters:
    
    tag - The tag to remove.
    
    Since:
    
    1.5
  - hasTag
```
public java.lang.Boolean hasTag(java.lang.String tagToFind)
```
    Checks whether the Location has a particular tag.
    
    Parameters:
    
    tagToFind - the string of the tag for which to check
    
    Returns:
    
    true if the tags include the specified tag, false otherwise
    
    Since:
    
    1.5
  - getAddress3
```
public java.lang.String getAddress3()
```
    Specified by:
    
    getAddress3 in interface Address
    
    Returns:
    
    the address3
    
    Since:
    
    1.8
  - setAddress3
```
public void setAddress3(java.lang.String address3)
```
    Specified by:
    
    setAddress3 in interface Address
    
    Parameters:
    
    address3 - the address3 to set
    
    Since:
    
    1.8
  - getAddress4
```
public java.lang.String getAddress4()
```
    Specified by:
    
    getAddress4 in interface Address
    
    Returns:
    
    the address4
    
    Since:
    
    1.8
  - setAddress4
```
public void setAddress4(java.lang.String address4)
```
    Specified by:
    
    setAddress4 in interface Address
    
    Parameters:
    
    address4 - the address4 to set
    
    Since:
    
    1.8
  - getAddress6
```
public java.lang.String getAddress6()
```
    Specified by:
    
    getAddress6 in interface Address
    
    Returns:
    
    the address6
    
    Since:
    
    1.8
  - setAddress6
```
public void setAddress6(java.lang.String address6)
```
    Specified by:
    
    setAddress6 in interface Address
    
    Parameters:
    
    address6 - the address6 to set
    
    Since:
    
    1.8
  - getAddress5
```
public java.lang.String getAddress5()
```
    Specified by:
    
    getAddress5 in interface Address
    
    Returns:
    
    the address5
    
    Since:
    
    1.8
  - setAddress5
```
public void setAddress5(java.lang.String address5)
```
    Specified by:
    
    setAddress5 in interface Address
    
    Parameters:
    
    address5 - the address5 to set
    
    Since:
    
    1.8
  - getId
```
public java.lang.Integer getId()
```
    Specified by:
    
    getId in interface OpenmrsObject
    
    Returns:
    
    id - The unique Identifier for the object
    
    Since:
    
    1.5
    
    See Also:
    
    OpenmrsObject.getId()
  - setId
```
public void setId(java.lang.Integer id)
```
    Specified by:
    
    setId in interface OpenmrsObject
    
    Parameters:
    
    id - - The unique Identifier for the object
    
    Since:
    
    1.5
    
    See Also:
    
    OpenmrsObject.setId(java.lang.Integer)

Class Location

Field Summary

Constructor Summary

Method Summary

Methods inherited from class org.openmrs.BaseCustomizableMetadata

Methods inherited from class org.openmrs.BaseOpenmrsMetadata

Methods inherited from class org.openmrs.BaseOpenmrsObject

Methods inherited from class java.lang.Object

Methods inherited from interface org.openmrs.OpenmrsObject

Field Detail

serialVersionUID

LOCATION_UNKNOWN

Constructor Detail

Location

Location

Method Detail

getAddress1

setAddress1

getAddress2

setAddress2

getCityVillage

setCityVillage

getCountry

setCountry

getLatitude

setLatitude

getLocationId

setLocationId

getLongitude

setLongitude

getPostalCode

setPostalCode

getStateProvince

setStateProvince

toString

getCountyDistrict

setCountyDistrict

getNeighborhoodCell

setNeighborhoodCell

findPossibleValues

getPossibleValues

hydrate

serialize

getDisplayString

getRegion

setRegion

getSubregion

setSubregion

getTownshipDivision

setTownshipDivision

getParentLocation

setParentLocation

getChildLocations

getChildLocations

setChildLocations

addChildLocation

isInHierarchy

removeChildLocation

getTags

setTags

addTag

removeTag

hasTag

getAddress3

setAddress3

getAddress4

setAddress4

getAddress6

setAddress6

getAddress5

setAddress5

getId

setId