.. _1.4.1:

1.4.1 Geolocation
====================

======== ==========
Required Repeatable
======== ==========
No       Yes
======== ==========


**Definition:** 

The spatial region where the data was collected or about which the data is focused. 

Repeat this property to indicate several different locations.

*Metadata fields:*

.. contents:: :local:

.. rubric:: Example DataCite XML

.. code:: xml

  <geoLocations>
    <geoLocation>
      <geoLocationPlace>Disko Bay</geoLocationPlace>
      <geoLocationPoint>
        <pointLongitude>-52.000000</pointLongitude>
        <pointLatitude>69.000000</pointLatitude>
      </geoLocationPoint>
    </geoLocation>
    <geoLocation>
      <geoLocationBox>
        <westBoundLongitude>-123.27</westBoundLongitude>
        <eastBoundLongitude>-123.225</eastBoundLongitude>
        <southBoundLatitude>49.24</southBoundLatitude>
        <northBoundLatitude>49.28</northBoundLatitude>
      </geoLocationBox>
    </geoLocation>
  </geoLocations>

.. _18:

DataCite 18 GeoLocation
~~~~~~~~~~~~~~~~~~~

**Occurrences:** 0-n

**Input type:** Text

**Example input:**

* University Hospital Geelong, Bellerine St, Geelong VIC 3220
* Whadjuk Noongar country
* Australia 
* Western Australia
* City of Stirling, Western Australia
* An ABS SLA

**Controlled vocabulary source:** DUO - Data Use Ontology

**Notes:**

Geolocation is not autofilled in the DataCite metadata.

Tools that help with finding coordinates include https://www.latlong.net/, and for box coordinates, http://bboxfinder.com/
For box coordinates, you can use this tool. 

DataCite 18 is human readable, and could use any number of sources. It is repeatable if you want to specify a number of Australian states without implying all states. That is to say, specify Western Australia, Tasmania, and South Australia rather than simply Australia.

Only one, if any, of 18.1, 18.2, 18.3, 18.4 should be filled in.

Refer to pages 29-32 of DataCite Metadata Schema 4.4


.. _18.1:

DataCite 18.1 geoLocationPoint
~~~~~~~~~~~~~~~~~~~~~~~~~

**Occurrences:** 0-1

**Input type:** One set of coordinates

**Example input:** -30.675715,120.025587

**Controlled vocabulary source:** Nil

**Notes:**

Decimal representation of longitude and latitude, negatives being south and west, positives being north and east.

.. _18.1.1:

DataCite 18.1.1 pointLongitude
^^^^^^^^^^^^^^^^^^^^^^^^^^

**Occurrences:** 1

**Input type:** Number

**Example input:** 120.025587

**Controlled vocabulary source:** Nil

**Notes:**

.. _18.1.2:

DataCite 18.1.2 pointLatitude
^^^^^^^^^^^^^^^^^^^^^^^^^^

**Occurrences:** 1

**Input type:** Number

**Example input:** -30.675715

**Notes:**

.. _18.2:

DataCite 18.2 geoLocationBox
~~~~~~~~~~~~~~~~~~~~~~~~~

**Occurrences:** 0-1

**Input type:** Two sets of coordinates

**Example input:** 
-46.255847,101.661014
-9.524914,153.468537

**Controlled vocabulary source:** Nil

**Notes:** A box is defined by two geographic points. Left low corner and right upper corner. Each point is defined by its longitude and latitude.

.. _18.2.1:

DataCite 18.2.1 westBoundLongitude
^^^^^^^^^^^^^^^^^^^^^^^^^^

**Occurrences:** 1

**Input type:** Number

**Example input:** 101.661014

**Controlled vocabulary source:** Nil

**Notes:**

.. _18.2.2:

DataCite 18.2.2 eastBoundLongitude
^^^^^^^^^^^^^^^^^^^^^^^^^^

**Occurrences:** 1

**Input type:** Number

**Example input:** 153.468537

**Controlled vocabulary source:** Nil

**Notes:**

.. _18.2.3:

DataCite 18.2.3 southBoundLatitude
^^^^^^^^^^^^^^^^^^^^^^^^^^

**Occurrences:** 1

**Input type:** Number

**Example input:** -46.255847

**Controlled vocabulary source:** Nil

**Notes:**

.. _18.2.4:

DataCite 18.2.4 northBoundLatitude
^^^^^^^^^^^^^^^^^^^^^^^^^^

**Occurrences:** 1

**Input type:** Number

**Example input:** -9.524914

**Controlled vocabulary source:** Nil

**Notes:**

.. _18.3:

DataCite 18.3 geoLocationPlace
~~~~~~~~~~~~~~~~~~~~~~~~~

**Occurrences:** 0-1

**Input type:** Text 

**Example input:** 

* Vast, hilltop building housing Australia's parliament, opened in 1988, topped by an 81m-high flagpole.
* Traditional lands of the Whadjuk Noongar people of Australia

**Controlled vocabulary source:** Nil

**Notes:**

.. _18.4:

DataCite 18.4 geoLocationPolygon
~~~~~~~~~~~~~~~~~~~~~~~~~

**Occurrences:** 0-n

**Input type** List of coordinates (at least three to draw a triangle)

**Notes:**

.. _18.4.1:

DataCite 18.4.1 polygonPoint
^^^^^^^^^^^^^^^^^^^^^^^^^^

**Occurrences:** 4-n

**Input type:** Nil

**Example input:** Nil

**Controlled vocabulary source:** Nil

**Notes:**

A polygon is delimited by geographic points. Each point is defined by a longitude latitude pair. The last point should be the same as the first point.

.. _18.4.1.1:

DataCite 18.4.1.1 pointLongitude
##########################

**Occurrences:** 1

**Input type:** Nil

**Example input:** Nil

**Controlled vocabulary source:** Nil

**Notes:**

.. _18.4.1.2:

DataCite 18.4.1.2 pointLatitude
##########################

**Occurrences:** 1

**Input type:** Nil

**Example input:** Nil

**Controlled vocabulary source:** Nil

**Notes:**

.. _18.4.2:

DataCite 18.4.2 inPolygonPoint
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

**Occurrences:** 0-1

***Input type:** Nil

**Example input:** Nil

**Controlled vocabulary source:** Nil

**Notes:**

inPolygonPoint is only necessary to indicate the "inside" of the polygon if the polygon is larger than half the earth. Otherwise the smallest of the two areas bounded by the polygon will be used.

.. _18.4.2.1:

DataCite 18.4.2.1 pointLongitude
##########################

**Occurrences:** 1

**Input type:** Nil

**Example input:** Nil

**Controlled vocabulary source:** Nil


.. _18.4.2.2:

DataCite 18.4.2.2 pointLatitude
##########################

**Occurrences:** 1

**Input type:** Nil

**Example input:** Nil

**Controlled vocabulary source:** Nil