.. _address.json#/:

address
=======

.. container:: title

 Location associated to the record

:type: ``object``

**Properties:** :ref:`address.json#/properties/cities`, :ref:`address.json#/properties/country_code`, :ref:`address.json#/properties/latitude`, :ref:`address.json#/properties/longitude`, :ref:`address.json#/properties/place_name`, :ref:`address.json#/properties/postal_address`, :ref:`address.json#/properties/postal_code`, :ref:`address.json#/properties/state`


.. _address.json#/properties/cities:

cities
++++++

.. container:: title

 List of cities

Sometimes conferences and institutes are officially located in a
little-known place, but their location is widely known as being in
a major neighboring city.  In this way, we can store information
about both the technically correct but little-known place and the
well-known but technically incorrect place.

The cities should be ordered from most specific to least specific.

:example: ``["Batavia", "Chicago"]``

:type: ``array``

:minItems: ``1``

.. container:: sub-title

 Every element of **cities**  is:

.. container:: title

 A city

:example: ``Geneva``

:type: ``string``

:minLength: ``1``


.. _address.json#/properties/country_code:

country_code
++++++++++++

:Reference: :ref:`country_code.json#/`


.. _address.json#/properties/latitude:

latitude
++++++++

.. container:: title

 Latitude of the location

:example: 50.7736

:type: ``number``


.. _address.json#/properties/longitude:

longitude
+++++++++

.. container:: title

 Longitude of the location

:example: 6.07532

:type: ``number``


.. _address.json#/properties/place_name:

place_name
++++++++++

Name of the specific place where this is located.

- For a Conference record, this could be an institution or a hotel
  hosting the conference.

  :MARC: ``270__b``
  :example: ``Dan Panorama hotel``

- For an Institution record representing an independent institute
  and not a department, this could be a university where it is
  located.

  :MARC: Not present.
  :example: ``U. Libre Brussels``

:type: ``string``

:minLength: ``1``


.. _address.json#/properties/postal_address:

postal_address
++++++++++++++

Full postal address in the original language, with
one element for every line, but excluding the country.

:example: ``["Notkestraße 85", "22607 Hamburg"]``

.. note::

    This is used for Institution records, but not for Conferences.

:type: ``array``

:minItems: ``1``

.. container:: sub-title

 Every element of **postal_address**  is:

:type: ``string``

:minLength: ``1``


.. _address.json#/properties/postal_code:

postal_code
+++++++++++

.. container:: title

 Postal code of the location

:example: 1050

:type: ``string``

:minLength: ``1``


.. _address.json#/properties/state:

state
+++++

.. container:: title

 State or province of the location

For American states, standard 2-letter codes are used.

:example: TX

:type: ``string``

:minLength: ``1``