How can we fetch offline mentoring sessions based on location?

[joffinjoy]

Based on our earlier understanding, fulfilment was supposed to have an address object which denoted the location that particular session would be delivered. Refer below sample schema:

{
	"catalog": {
		"descriptor": {},
		"providers": [{
			"categories": [{}],
			"items": [],
			"fulfillments": [{
				"address": {
					"full": "Full Address",
					"door": "Door No Address",
					"name": "Name on the Address",
					"building": "Full Address",
					"street": "Street Address",
					"locality": "Locality",
					"ward": "Ward Name or Number",
					"city": "City",
					"state": "State",
					"country": "Country Code",
					"area_code": "Area Code"
				}
			}]
		}]

	}
}

But in current 1.x core schema, fulfilment no longer have a schema that can hold an address in any shape or form. Instead, now locations are stored at provider level and each item holds an array of location_ids.

This doesn't translate well to mentoring scenarios like:

A session (item) having multiple slots (fulfilments) which are delivered at different locations at different times.

Ideally having locations in fulfilment enables the above scenario. Please advice on how to proceed forward with this.

---

Subsequently, what will the intent of a search request looks like when searching for "sessions by location"? Is this a fair representation (Adapted to latest location schema):

"intent": {
	"item": {
		"descriptor": {
			"name": "10th Std Mathematics"
		}
	},
	"descriptor": {
		"name": "10th Std Mathematics"
	},
	"fulfillment": {
		"type": "offline"
	},
	"location:" {
		"gps": "<string>,
		"city": {
			"code": "<string>",
			"name": "<string>"
		},
		"district": {
			"code": "<string>",
			"name": "<string>"
		},
		"state": {
			"code": "<string>",
			"name": "<string>"
		},
		"country": {
			"code": "<string>",
			"name": "<string>"
		},
		"area_code": "<string>"
	}
}

If this is a fair representation, We are interested in understanding the required granularity of location. Like if we specify a city, do we need to specify state and country too, or is city code enough to uniquely identify the location?

cc: @ravi-prakash-v, @aks30, @vijiurs, @kiranharidas187