PositionField

The position field has been present in MediaHaven from at least version 21.2. In version 24.3 it has undergone a major overhaul to offer the end-user more control over it.

Introduction

The position field describes a position on the Earth’s surface. It is one of the Complex Fields extending the MapField and consisting of several child fields describing the following properties of a position

The location, specified as the longitude and latitude on Earth’s surface, e.g. 51.235895,2.972828
The formatted address, e.g. Zandstraat 10, 8450 Bredene, België
Parts of the address (country, city, street, etc)

Enhancement

The user can provide the location, formatted address, or both. When the location or formatted address is missing, the system automatically enhances the missing information using an external framework (Google Maps API).

From version 24.3 the enhancement will never overwrite the user-provided location or address, but keep them as is, even if the user-provided address is unknown to the Google Maps API.

User provides location	User provides address	Outcome

User provides location	User provides address	Outcome
Yes	Yes	Keep both location and address Generate address parts based on the location
No	Yes	Generate location and address parts based on the address Keep the address unchanged
Yes	No	Generate the address and address parts based on the location Keep the location unchanged
No	No	Clear the address parts if present

Structure

The PositionField is a specialized version of a MapField with the following child fields

Key	Type	Read-Only	Index Properties	Example

Key	Type	Index Properties	Example
`Location`	`GeoCoordinateField`	Index	`51.235895,2.972828`
`Address`	`SimpleField`	Index, Global, Tokenized	`Zandstraat 10, 8450 Bredene, België`
`Country`	`SimpleField`		`België`
`Area`	`SimpleField`		`Vlaanderen`
`Subarea`	`SimpleField`		`West-Vlaanderen`
`Locality`	`SimpleField`		`Bredene`
`Postal`	`SimpleField`		`8450`
`Street`	`SimpleField`		`Zandstraat`
`Number`	`SimpleField`		`10`