2024-03-20 Population Density Data - Meeting Minutes

Owned by Jorge Garcia Hospital
Last updated: Mar 22, 2024
3 min read

CAMARA Population Density Data API - Follow-up meeting #4 - 2024-03-20

March 20th, 2024

Attendees

ย 

ย 

Gregory Liokumovich (Ericsson)

Rafal Artych (DT)

Violeta Gonzalez Fernandez (Telefonica)

Sachin Kumar (Vodafone)

Jorge Garcia Hospital (Telefonica)

ย 

Population Density Data API minutes:ย https://lf-camaraproject.atlassian.net/wiki/display/CAM/Population+Density+Data+API+Minutes

Agenda

  • Approval of previous meeting minutes #3 and meeting agenda

  • Open issues and PRs

    • PRs: #5

    • Issues: #6 #7 #10

  • Initial algorithm proposal review

  • Timeline and next steps

  • AoB

Open Issues & PRs

ย 

ITEM

WHO

DESCRIPTION

ITEM

WHO

DESCRIPTION

PR#5

Telefonica

Initial contribution of the Population Density API spec

Issue#6

Telefonica

Information in water zones discussion

Issue#7

Telefonica

Default and limit values for the API Characteristics

Issue#10

Telefonica

Management of "big" responses

Approval of previous meeting minutes & documentation (1)

Meeting Minutes #3

API proposal review (2)

Different discussions raised during the API review:

  • Issue#6ย Information in water zones: Operators and therefore API can only provide data of those zones where it is operating. Full water or hybrid scenarios to be covered.

    Status parameter is proposed for handling both situations:

    • Partial response, if only some areas are not included in the response due to the

    • Empty response, if no area is managed by operator and, therefore, no information can be provided.

    Proposed values (to be agreed):

    โ†’ Values for status (initial proposal): "enum": ["OK_SUPPORTED_AREA" โ†’ "AREA_SUPPORTED", "PART_OF_ AREA_NOT_SUPPORTED", "AREA_NOT_SUPPORTED"]ย 

    ย 

    Agreed WF

โ†’ offline discussion on partial responses.ย 

โ†’ agreed on the values for the status parameter

ย 

  • Issue#7ย Open discussion on default and limit values for the API characteristics:

    • Close time frame limits in t=0 (min) and reduce max to t=(3)months (max) with data prediction algorithm in all the timeframe. That covers current use case.

    • Document in the API yaml that response will include equal-sized cells, focusing on the geohash cells format.

    • 1 week (7 days) is proposed as maximum time frame length.

    • Maintain 1 hour as the time granularity for the response.

    • Default value on level 7 (150m x 150m) (TBC).ย Open Discussion, please provide feedback.

    • Maximum requested area size, need to consider a feasible maximum response size jointly with the maximum length of the timeframe. Dependency withย Discussion on API spec - how to handle big areas/time in the responseย #10ย Open Discussion, please provide feedback.

Agreed WF

ย โ†’ Open discussion on maintaining the default geohash level in 7, but include an optional parameter in the request for the consumer to select a different value. "Not supported" error to be analyzed on those cases

Following the discussion on maximum time frame and area to cover, we've been analyzing the management of valid/useful requests and the corresponding response. Considering the size of a common request, of 1 week and common areas of around 10Km2, the size of the response's content may be too big for being handled directly in the API REST body.

Proposal to analyse

Proposal is to analyze the implementation a unique asynchronous mechanisms for being able to handle both kind of scenarios, small scenarios where response will reach soon but also time and resource consuming scenarios where it may take even minutes to calculate the response.

Agreed WF

โ†’ Gregory: to analyze limiting the size of the request to avoid complexity in the response, at least to consider response size that can fit properly in a HTTP response.

โ†’ Keep discussion in the issue offline.

Initial algorithm proposal (3)

ย 

Population Density API - Algorithm.pdf

Feedback:

Agreed WF

โ†’ Issue to be opened to keep the discussion offline.

ย 

Discussion

Item

Discussion

Item

Discussion

PR#5

Initial contribution of the Population Density API spec โ†’ To be merged into main to continue discussion

Issue#6

Information in water zones discussion โ†’ Agreed status values, open mechanism for partial result

Issue#7

Default and limit values for the API Characteristics โ†’ Open on level and max area

Issue#10

Management of "big" responses โ†’ Open discussion on mechanism

AoB

-

Next steps

  1. Feedback on algorithm proposalโ†’ Follow-up meeting #5

  2. Feedback on the big responses management #5

  3. RC API spec agreement โ†’ Follow-up meeting #6

  • Next call will be April 10th, 2024