Serviceability Construct Enhancement | Polygons | geoJSON

[tanya-ondc]

Objective

The objective is to enhance the location based serviceability construct to define the fulfillment area serviceable by the provider.
The geographical boundaries within which the merchants are able to fulfill the orders defines the location based serviceability for the provider.

Current construct

The location object currently has a circle object specifying the gps coordinates and radius to define the boundary area based on the geometric radius.

"locations":
          [
            {
              "id":"L1",
              "gps":"12.967555,77.749666",
              "address": "Jayanagar 4th Block, ",
              "area_code":"560076",
                "state":
                {
                  "name":"Bengaluru",
                  "code":"std:080"
                }
              "circle":
              {
                "gps":"12.967555,77.749666",
                "radius":
                {
                  "unit":"km",
                  "value":"3"
                }
              }
	]

However, the circle based location construct has issues with its application. Most of all, the sellers do not offer consistent services across uniformly spread geolocations. They generally have a non-uniform area of coverage for providing goods and services, specially in case of hyperlocal and milkrun commerce. Therefore, it is pertinent that the sellers on the network are able to provide the non-uniform area to define serviceability.

Location.polygon is also a string, which needs to be enahanced to be able to parse boundary coordinates of linear ring.

Proposed Solution:

A polygon defines a series of coordinates arranged in a closed area in an ordered sequence. Polygons enhances the serviceability for a merchant, where the merchant is not limited only to the radius around the gps coordinate, but can provide lat-long coordinates for defining the geo boundaries which results in an optimised area of service with a closed bound of a location.

Using Geospatial GeoJSON location construct:
GeoJSON is an open source geospatial data interchange format based on JavaScript Object Notation (JSON). It defines several types of JSON objects and the manner in which they are combined to represent data about geographic features, their properties, and their spatial extents.

We can define geoJSON to define coordinates for geometry types: Polygon and MultiPolygon.

Example geoJSON:

1. Polygon:

geoJSON Schema for Polygon - https://geojson.org/schema/Polygon.json
Visualize geoJSON here - https://geojson.io/#

Example -

{
    "type": "FeatureCollection",
    "features": [
        {
            "type": "Feature",
            "properties": {},
            "geometry": {
                "coordinates": [
                    [
                        [
                            77.17557124364345,
                            28.675927920960092
                        ],
                        [
                            77.12873700880397,
                            28.600972470604688
                        ],
                        [
                            77.44693431021358,
                            28.54532578327904
                        ],
                        [
                            77.17557124364345,
                            28.675927920960092
                        ]
                    ]
                ],
                "type": "Polygon"
            }
        }
    ]
}

2. Multi-polygon and Polygon with holes:

Schema for Multi-polygons - https://geojson.org/schema/MultiPolygon.json
Visualize geoJSON here - https://geojson.io/#

Example:

{
    "type": "FeatureCollection",
    "features": [
        {
            "type": "Feature",
            "properties": {},
            "geometry": {
                "coordinates": [
                    [
                        [
                            [
                                77.43665130303793,
                                14.623085187953805
                            ],
                            [
                                75.5973534574374,
                                13.250722119415386
                            ],
                            [
                                76.83595576386841,
                                11.932994282693713
                            ],
                            [
                                78.77093962455899,
                                11.329016077894806
                            ],
                            [
                                79.81285401108431,
                                12.831241396333581
                            ],
                            [
                                78.919784536919,
                                14.530479198829909
                            ],
                            [
                                77.43665130303793,
                                14.623085187953805
                            ]
                        ],
                        [
                            [
                                76.8997464405947,
                                13.684976332921366
                            ],
                            [
                                77.71839345857865,
                                13.462777993060513
                            ],
                            [
                                77.44728308249296,
                                12.991867329390288
                            ],
                            [
                                76.79342864605093,
                                13.188621870721974
                            ],
                            [
                                76.8997464405947,
                                13.684976332921366
                            ]
                        ],
                        [
                            [
                                78.9615475747243,
                                13.142822561104325
                            ],
                            [
                                79.45655560976002,
                                13.094613637581034
                            ],
                            [
                                79.03933455165907,
                                12.722401456832372
                            ],
                            [
                                78.9615475747243,
                                13.142822561104325
                            ]
                        ]
                    ],
                    [
                        [
                            [
                                75.6948922787945,
                                15.992882117830902
                            ],
                            [
                                74.83199950867888,
                                14.85156668614404
                            ],
                            [
                                77.40061054530446,
                                15.122951529972369
                            ],
                            [
                                75.6948922787945,
                                15.992882117830902
                            ]
                        ]
                    ]
                ],
                "type": "MultiPolygon"
            }
        }
    ]
}

Example Polygon:

Enhancing current schema of polygon:

polygon:
   description: The boundary polygon of this location
   type: string

to an array of gps coordinates.

"polygon": [
    "77.17557124364345, 28.675927920960092",
    "77.12873700880397, 28.600972470604688",
    "77.44693431021358, 28.54532578327904",
    "77.17557124364345, 28.675927920960092"
]

Kindly review and share your thoughts around this.