{"action":"created","comment":{"url":"https://api.github.com/repos/telefonicaid/fiware-orion/pulls/comments/47235321","id":47235321,"diff_hunk":"@@ -282,6 +270,110 @@ Error list (HTTP response code in paranthesis):\n * UnsupportedMediaType (415). Request content type is not supported.\n * InvalidModification (422). Some piece of information is missing in payload.\n \n+## Geospatial properties of entities\n+\n+The geospatial properties of a context entity can be represented by means of regular context attributes.\n+The provision of geospatial properties enables the resolution of geographical queries.\n+\n+Two different syntaxes must be supported by compliant implementations: \n+\n+* *Simple Location Format*. It is meant as a very lightweight format that developers and users can quickly\n+and easily add to their existing entities with little effort.\n+\n+* *GeoJSON*.  [GeoJSON](https://tools.ietf.org/html/draft-butler-geojson-06)\n+is a geospatial data interchange format based on the JavaScript Object Notation (JSON). GeoJSON provides greater flexibility\n+allowing the representation of complex geospatial features.\n+\n+Additionally, geospatial properties might be declared by means of [civic addresses](https://schema.org/PostalAddress),\n+but in that particular case context producers will have to implement their own geocoding procedures,\n+so that geographical queries can be resolved.\n+\n+Implementations are responsible for determining which entity attributes convey geospatial properties (by inspecting\n+the NGSI type associated to attributes). Typically it will be an entity attribute named `location`,\n+but nothing prevents use cases where an entity contains more than one geospatial attribute. For instance,\n+locations specified at different granularity levels or provided by different location methods with different accuracy. \n+Nonetheless, it is noteworthy the fact that spatial properties\n+need special indexes which can be under resource constraints imposed by backend databases. Thus, implementations may raise errors","path":"doc/apiary/v2/fiware-ngsiv2-reference.apib","position":null,"original_position":46,"commit_id":"e396fd3c6f10ad85e68dcdc0481dfbfd3624c397","original_commit_id":"0ca7691cd98adbf7ae82a2b5fdb9065bc47b38ef","user":{"login":"jmcanterafonseca","id":694782,"avatar_url":"https://avatars.githubusercontent.com/u/694782?v=3","gravatar_id":"","url":"https://api.github.com/users/jmcanterafonseca","html_url":"https://github.com/jmcanterafonseca","followers_url":"https://api.github.com/users/jmcanterafonseca/followers","following_url":"https://api.github.com/users/jmcanterafonseca/following{/other_user}","gists_url":"https://api.github.com/users/jmcanterafonseca/gists{/gist_id}","starred_url":"https://api.github.com/users/jmcanterafonseca/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/jmcanterafonseca/subscriptions","organizations_url":"https://api.github.com/users/jmcanterafonseca/orgs","repos_url":"https://api.github.com/users/jmcanterafonseca/repos","events_url":"https://api.github.com/users/jmcanterafonseca/events{/privacy}","received_events_url":"https://api.github.com/users/jmcanterafonseca/received_events","type":"User","site_admin":false},"body":"fixed https://github.com/jmcanterafonseca/fiware-orion/commit/e396fd3c6f10ad85e68dcdc0481dfbfd3624c397","created_at":"2015-12-10T14:57:44Z","updated_at":"2015-12-10T14:57:44Z","html_url":"https://github.com/telefonicaid/fiware-orion/pull/1524#discussion_r47235321","pull_request_url":"https://api.github.com/repos/telefonicaid/fiware-orion/pulls/1524","_links":{"self":{"href":"https://api.github.com/repos/telefonicaid/fiware-orion/pulls/comments/47235321"},"html":{"href":"https://github.com/telefonicaid/fiware-orion/pull/1524#discussion_r47235321"},"pull_request":{"href":"https://api.github.com/repos/telefonicaid/fiware-orion/pulls/1524"}}},"pull_request":{"url":"https://api.github.com/repos/telefonicaid/fiware-orion/pulls/1524","id":51343123,"html_url":"https://github.com/telefonicaid/fiware-orion/pull/1524","diff_url":"https://github.com/telefonicaid/fiware-orion/pull/1524.diff","patch_url":"https://github.com/telefonicaid/fiware-orion/pull/1524.patch","issue_url":"https://api.github.com/repos/telefonicaid/fiware-orion/issues/1524","number":1524,"state":"open","locked":false,"title":"ADD Location specification to the FIWARE-NGSIv2","user":{"login":"jmcanterafonseca","id":694782,"avatar_url":"https://avatars.githubusercontent.com/u/694782?v=3","gravatar_id":"","url":"https://api.github.com/users/jmcanterafonseca","html_url":"https://github.com/jmcanterafonseca","followers_url":"https://api.github.com/users/jmcanterafonseca/followers","following_url":"https://api.github.com/users/jmcanterafonseca/following{/other_user}","gists_url":"https://api.github.com/users/jmcanterafonseca/gists{/gist_id}","starred_url":"https://api.github.com/users/jmcanterafonseca/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/jmcanterafonseca/subscriptions","organizations_url":"https://api.github.com/users/jmcanterafonseca/orgs","repos_url":"https://api.github.com/users/jmcanterafonseca/repos","events_url":"https://api.github.com/users/jmcanterafonseca/events{/privacy}","received_events_url":"https://api.github.com/users/jmcanterafonseca/received_events","type":"User","site_admin":false},"body":"","created_at":"2015-11-20T11:00:20Z","updated_at":"2015-12-10T14:57:44Z","closed_at":null,"merged_at":null,"merge_commit_sha":"7aa640ae9e7068fc67347cb697ca2c064126a762","assignee":null,"milestone":null,"commits_url":"https://api.github.com/repos/telefonicaid/fiware-orion/pulls/1524/commits","review_comments_url":"https://api.github.com/repos/telefonicaid/fiware-orion/pulls/1524/comments","review_comment_url":"https://api.github.com/repos/telefonicaid/fiware-orion/pulls/comments{/number}","comments_url":"https://api.github.com/repos/telefonicaid/fiware-orion/issues/1524/comments","statuses_url":"https://api.github.com/repos/telefonicaid/fiware-orion/statuses/e396fd3c6f10ad85e68dcdc0481dfbfd3624c397","head":{"label":"jmcanterafonseca:Location_spec","ref":"Location_spec","sha":"e396fd3c6f10ad85e68dcdc0481dfbfd3624c397","user":{"login":"jmcanterafonseca","id":694782,"avatar_url":"https://avatars.githubusercontent.com/u/694782?v=3","gravatar_id":"","url":"https://api.github.com/users/jmcanterafonseca","html_url":"https://github.com/jmcanterafonseca","followers_url":"https://api.github.com/users/jmcanterafonseca/followers","following_url":"https://api.github.com/users/jmcanterafonseca/following{/other_user}","gists_url":"https://api.github.com/users/jmcanterafonseca/gists{/gist_id}","starred_url":"https://api.github.com/users/jmcanterafonseca/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/jmcanterafonseca/subscriptions","organizations_url":"https://api.github.com/users/jmcanterafonseca/orgs","repos_url":"https://api.github.com/users/jmcanterafonseca/repos","events_url":"https://api.github.com/users/jmcanterafonseca/events{/privacy}","received_events_url":"https://api.github.com/users/jmcanterafonseca/received_events","type":"User","site_admin":false},"repo":{"id":31965771,"name":"fiware-orion","full_name":"jmcanterafonseca/fiware-orion","owner":{"login":"jmcanterafonseca","id":694782,"avatar_url":"https://avatars.githubusercontent.com/u/694782?v=3","gravatar_id":"","url":"https://api.github.com/users/jmcanterafonseca","html_url":"https://github.com/jmcanterafonseca","followers_url":"https://api.github.com/users/jmcanterafonseca/followers","following_url":"https://api.github.com/users/jmcanterafonseca/following{/other_user}","gists_url":"https://api.github.com/users/jmcanterafonseca/gists{/gist_id}","starred_url":"https://api.github.com/users/jmcanterafonseca/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/jmcanterafonseca/subscriptions","organizations_url":"https://api.github.com/users/jmcanterafonseca/orgs","repos_url":"https://api.github.com/users/jmcanterafonseca/repos","events_url":"https://api.github.com/users/jmcanterafonseca/events{/privacy}","received_events_url":"https://api.github.com/users/jmcanterafonseca/received_events","type":"User","site_admin":false},"private":false,"html_url":"https://github.com/jmcanterafonseca/fiware-orion","description":"FI-WARE Orion Context Broker","fork":true,"url":"https://api.github.com/repos/jmcanterafonseca/fiware-orion","forks_url":"https://api.github.com/repos/jmcanterafonseca/fiware-orion/forks","keys_url":"https://api.github.com/repos/jmcanterafonseca/fiware-orion/keys{/key_id}","collaborators_url":"https://api.github.com/repos/jmcanterafonseca/fiware-orion/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/jmcanterafonseca/fiware-orion/teams","hooks_url":"https://api.github.com/repos/jmcanterafonseca/fiware-orion/hooks","issue_events_url":"https://api.github.com/repos/jmcanterafonseca/fiware-orion/issues/events{/number}","events_url":"https://api.github.com/repos/jmcanterafonseca/fiware-orion/events","assignees_url":"https://api.github.com/repos/jmcanterafonseca/fiware-orion/assignees{/user}","branches_url":"https://api.github.com/repos/jmcanterafonseca/fiware-orion/branches{/branch}","tags_url":"https://api.github.com/repos/jmcanterafonseca/fiware-orion/tags","blobs_url":"https://api.github.com/repos/jmcanterafonseca/fiware-orion/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/jmcanterafonseca/fiware-orion/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/jmcanterafonseca/fiware-orion/git/refs{/sha}","trees_url":"https://api.github.com/repos/jmcanterafonseca/fiware-orion/git/trees{/sha}","statuses_url":"https://api.github.com/repos/jmcanterafonseca/fiware-orion/statuses/{sha}","languages_url":"https://api.github.com/repos/jmcanterafonseca/fiware-orion/languages","stargazers_url":"https://api.github.com/repos/jmcanterafonseca/fiware-orion/stargazers","contributors_url":"https://api.github.com/repos/jmcanterafonseca/fiware-orion/contributors","subscribers_url":"https://api.github.com/repos/jmcanterafonseca/fiware-orion/subscribers","subscription_url":"https://api.github.com/repos/jmcanterafonseca/fiware-orion/subscription","commits_url":"https://api.github.com/repos/jmcanterafonseca/fiware-orion/commits{/sha}","git_commits_url":"https://api.github.com/repos/jmcanterafonseca/fiware-orion/git/commits{/sha}","comments_url":"https://api.github.com/repos/jmcanterafonseca/fiware-orion/comments{/number}","issue_comment_url":"https://api.github.com/repos/jmcanterafonseca/fiware-orion/issues/comments{/number}","contents_url":"https://api.github.com/repos/jmcanterafonseca/fiware-orion/contents/{+path}","compare_url":"https://api.github.com/repos/jmcanterafonseca/fiware-orion/compare/{base}...{head}","merges_url":"https://api.github.com/repos/jmcanterafonseca/fiware-orion/merges","archive_url":"https://api.github.com/repos/jmcanterafonseca/fiware-orion/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/jmcanterafonseca/fiware-orion/downloads","issues_url":"https://api.github.com/repos/jmcanterafonseca/fiware-orion/issues{/number}","pulls_url":"https://api.github.com/repos/jmcanterafonseca/fiware-orion/pulls{/number}","milestones_url":"https://api.github.com/repos/jmcanterafonseca/fiware-orion/milestones{/number}","notifications_url":"https://api.github.com/repos/jmcanterafonseca/fiware-orion/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/jmcanterafonseca/fiware-orion/labels{/name}","releases_url":"https://api.github.com/repos/jmcanterafonseca/fiware-orion/releases{/id}","created_at":"2015-03-10T15:39:54Z","updated_at":"2015-03-10T15:40:00Z","pushed_at":"2015-12-10T14:53:37Z","git_url":"git://github.com/jmcanterafonseca/fiware-orion.git","ssh_url":"git@github.com:jmcanterafonseca/fiware-orion.git","clone_url":"https://github.com/jmcanterafonseca/fiware-orion.git","svn_url":"https://github.com/jmcanterafonseca/fiware-orion","homepage":"http://catalogue.fi-ware.eu/enablers/publishsubscribe-context-broker-orion-context-broker","size":17898,"stargazers_count":0,"watchers_count":0,"language":"C++","has_issues":false,"has_downloads":true,"has_wiki":true,"has_pages":true,"forks_count":1,"mirror_url":null,"open_issues_count":0,"forks":1,"open_issues":0,"watchers":0,"default_branch":"develop"}},"base":{"label":"telefonicaid:develop","ref":"develop","sha":"1736125cdb6b4b8bffc1dd253d69fd60f0019ce2","user":{"login":"telefonicaid","id":968363,"avatar_url":"https://avatars.githubusercontent.com/u/968363?v=3","gravatar_id":"","url":"https://api.github.com/users/telefonicaid","html_url":"https://github.com/telefonicaid","followers_url":"https://api.github.com/users/telefonicaid/followers","following_url":"https://api.github.com/users/telefonicaid/following{/other_user}","gists_url":"https://api.github.com/users/telefonicaid/gists{/gist_id}","starred_url":"https://api.github.com/users/telefonicaid/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/telefonicaid/subscriptions","organizations_url":"https://api.github.com/users/telefonicaid/orgs","repos_url":"https://api.github.com/users/telefonicaid/repos","events_url":"https://api.github.com/users/telefonicaid/events{/privacy}","received_events_url":"https://api.github.com/users/telefonicaid/received_events","type":"Organization","site_admin":false},"repo":{"id":12808420,"name":"fiware-orion","full_name":"telefonicaid/fiware-orion","owner":{"login":"telefonicaid","id":968363,"avatar_url":"https://avatars.githubusercontent.com/u/968363?v=3","gravatar_id":"","url":"https://api.github.com/users/telefonicaid","html_url":"https://github.com/telefonicaid","followers_url":"https://api.github.com/users/telefonicaid/followers","following_url":"https://api.github.com/users/telefonicaid/following{/other_user}","gists_url":"https://api.github.com/users/telefonicaid/gists{/gist_id}","starred_url":"https://api.github.com/users/telefonicaid/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/telefonicaid/subscriptions","organizations_url":"https://api.github.com/users/telefonicaid/orgs","repos_url":"https://api.github.com/users/telefonicaid/repos","events_url":"https://api.github.com/users/telefonicaid/events{/privacy}","received_events_url":"https://api.github.com/users/telefonicaid/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/telefonicaid/fiware-orion","description":"FIWARE Orion Context Broker","fork":false,"url":"https://api.github.com/repos/telefonicaid/fiware-orion","forks_url":"https://api.github.com/repos/telefonicaid/fiware-orion/forks","keys_url":"https://api.github.com/repos/telefonicaid/fiware-orion/keys{/key_id}","collaborators_url":"https://api.github.com/repos/telefonicaid/fiware-orion/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/telefonicaid/fiware-orion/teams","hooks_url":"https://api.github.com/repos/telefonicaid/fiware-orion/hooks","issue_events_url":"https://api.github.com/repos/telefonicaid/fiware-orion/issues/events{/number}","events_url":"https://api.github.com/repos/telefonicaid/fiware-orion/events","assignees_url":"https://api.github.com/repos/telefonicaid/fiware-orion/assignees{/user}","branches_url":"https://api.github.com/repos/telefonicaid/fiware-orion/branches{/branch}","tags_url":"https://api.github.com/repos/telefonicaid/fiware-orion/tags","blobs_url":"https://api.github.com/repos/telefonicaid/fiware-orion/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/telefonicaid/fiware-orion/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/telefonicaid/fiware-orion/git/refs{/sha}","trees_url":"https://api.github.com/repos/telefonicaid/fiware-orion/git/trees{/sha}","statuses_url":"https://api.github.com/repos/telefonicaid/fiware-orion/statuses/{sha}","languages_url":"https://api.github.com/repos/telefonicaid/fiware-orion/languages","stargazers_url":"https://api.github.com/repos/telefonicaid/fiware-orion/stargazers","contributors_url":"https://api.github.com/repos/telefonicaid/fiware-orion/contributors","subscribers_url":"https://api.github.com/repos/telefonicaid/fiware-orion/subscribers","subscription_url":"https://api.github.com/repos/telefonicaid/fiware-orion/subscription","commits_url":"https://api.github.com/repos/telefonicaid/fiware-orion/commits{/sha}","git_commits_url":"https://api.github.com/repos/telefonicaid/fiware-orion/git/commits{/sha}","comments_url":"https://api.github.com/repos/telefonicaid/fiware-orion/comments{/number}","issue_comment_url":"https://api.github.com/repos/telefonicaid/fiware-orion/issues/comments{/number}","contents_url":"https://api.github.com/repos/telefonicaid/fiware-orion/contents/{+path}","compare_url":"https://api.github.com/repos/telefonicaid/fiware-orion/compare/{base}...{head}","merges_url":"https://api.github.com/repos/telefonicaid/fiware-orion/merges","archive_url":"https://api.github.com/repos/telefonicaid/fiware-orion/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/telefonicaid/fiware-orion/downloads","issues_url":"https://api.github.com/repos/telefonicaid/fiware-orion/issues{/number}","pulls_url":"https://api.github.com/repos/telefonicaid/fiware-orion/pulls{/number}","milestones_url":"https://api.github.com/repos/telefonicaid/fiware-orion/milestones{/number}","notifications_url":"https://api.github.com/repos/telefonicaid/fiware-orion/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/telefonicaid/fiware-orion/labels{/name}","releases_url":"https://api.github.com/repos/telefonicaid/fiware-orion/releases{/id}","created_at":"2013-09-13T11:55:25Z","updated_at":"2015-11-25T10:36:09Z","pushed_at":"2015-12-10T14:53:37Z","git_url":"git://github.com/telefonicaid/fiware-orion.git","ssh_url":"git@github.com:telefonicaid/fiware-orion.git","clone_url":"https://github.com/telefonicaid/fiware-orion.git","svn_url":"https://github.com/telefonicaid/fiware-orion","homepage":"http://catalogue.fiware.org/enablers/publishsubscribe-context-broker-orion-context-broker","size":18764,"stargazers_count":36,"watchers_count":36,"language":"C++","has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":true,"forks_count":48,"mirror_url":null,"open_issues_count":256,"forks":48,"open_issues":256,"watchers":36,"default_branch":"develop"}},"_links":{"self":{"href":"https://api.github.com/repos/telefonicaid/fiware-orion/pulls/1524"},"html":{"href":"https://github.com/telefonicaid/fiware-orion/pull/1524"},"issue":{"href":"https://api.github.com/repos/telefonicaid/fiware-orion/issues/1524"},"comments":{"href":"https://api.github.com/repos/telefonicaid/fiware-orion/issues/1524/comments"},"review_comments":{"href":"https://api.github.com/repos/telefonicaid/fiware-orion/pulls/1524/comments"},"review_comment":{"href":"https://api.github.com/repos/telefonicaid/fiware-orion/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/telefonicaid/fiware-orion/pulls/1524/commits"},"statuses":{"href":"https://api.github.com/repos/telefonicaid/fiware-orion/statuses/e396fd3c6f10ad85e68dcdc0481dfbfd3624c397"}}}}