Revise Geomaps API wording

[jri]

The methods and parameters of the Geomaps service should consistently reflect this nomenclature:

Geo Coordinate -- a lon/lat value. Represented as topic of type "Geo Coordinate".
Geo Topic -- a topic that is facetted with a Geo Coordinate, e.g. an Address.
Domain Topic -- The application-specific topic that is virtually placed on a Geomap, e.g. a Person.
Geomap -- A topicmap with an underlying geo cooordinate system. A geomap holds a collection of Geo Coordinates. To the user it looks as it would hold Domain Topics.

[Jörg Richter]

Revise Geomaps API wording (#645).

The Geomap model class is now an iterable over its Geo Coordinates.

BREAKING CHANGES in Geomaps API:

Renamed:

getGeoTopic(long topicId) -> getDomainTopic(long geoCoordId)
addTopicToGeomap(long geomapId, long topicId) -> addCoordinateToGeomap(long geomapId, long geoCoordId)

Dropped:

getGeomapTopics(long geomapId)

RESTClient:

dm4c.restc.get_geotopic(topic_id) -> ..get_domain_topic(geo_coord_id)
dm4c.restc.add_topic_to_geomap(geomap_id, topic_id) -> ..add_coordinate_to_geomap(geomap_id, geo_coord_id)

See #645.

• Changeset: 0a0ae0812e2dadc8c68eb7360b337445953c4dcb
• URL: ​https://github.com/jri/deepamehta/commit/0a0ae0812e2dadc8c68eb7360b337445953c4dcb

[Jörg Richter]

Geomaps API: add getGeoCoordinate() (#645).

New in Geomaps API:

GeoCoordinate getGeoCoordinate(Topic geoTopic)

Returns the geo coordinate of a geo-facetted topic (e.g. an Address).

New model class:

de.deepamehta.plugins.geomaps.model.GeoCoordinate

A long/lat value.

See #645.

• Changeset: 66c69dcce9e1ba713e2136cdc66c7c637a70cdb1
• URL: ​https://github.com/jri/deepamehta/commit/66c69dcce9e1ba713e2136cdc66c7c637a70cdb1

[Jörg Richter]

Geomaps API: fix getGeoCoordinate() (#645).

getGeoCoordinate() returns null if no geo coordinate is stored (as specified in contract). No exception is thrown.

See #645.

• Changeset: 0360dd76787ad515a39b8956809a7a275e243f48
• URL: ​https://github.com/jri/deepamehta/commit/0360dd76787ad515a39b8956809a7a275e243f48