Add support for using latest version of GSP boundaries (20251204)

[JamieTaylor-TUOS]

A new version of the GSP Boundaries for GB Grid Supply Points dataset (20251204) has been published to the NESO Data Portal, see https://www.neso.energy/data-portal/gis-boundaries-gb-grid-supply-points

Add [backwards-compatible] support for reverse geocoding using this version of the GSP boundaries.

@SheffieldSolar/ocf FYI, PV_Live GSP outturns will be switched to this new set of GSP boundaries at a later date (more anon, just tagging for awareness)

[Herald-TUOS]

@JamieTaylor-TUOS , the newly published GSP boundaries are consistent with the previous version, but the version published on 20220314 is in different format. Is it possible to make this (20220314) version consistent with newer versions? We could avoid code repetition if all the versions are in consistent format.

For comparison, here is the method for loading GSP boundaries version 20220314:

Geocode/geocode/neso.py

Lines 147 to 189 in 6e7ce40

	def _load_gsp_boundaries_20220314(self):
	"""
	Load the 20220314 GSP / GNode boundaries, either from local cache if available, else fetch
	from ESO Data Portal API.
	Returns
	-------
	gsp_regions: GeoPandas.GeoDataFrame
	A geodataframe of MultiPolygons for the GSP boundaries.
	"""
	gsp_boundaries_cache_contents = self.cache_manager.retrieve(
	self.gsp_boundaries_20220314_cache_file
	)
	if gsp_boundaries_cache_contents is not None:
	logging.debug(
	"Loading 20220314 GSP boundaries from cache ('%s')",
	self.gsp_boundaries_20220314_cache_file,
	)
	return gsp_boundaries_cache_contents
	logging.info(
	"Extracting the 20220314 GSP boundary data from NESO's Data Portal API (this "
	"only needs to be done once)"
	)
	eso_url = "https://api.neso.energy/dataset/2810092e-d4b2-472f-b955-d8bea01f9ec0/resource/08534dae-5408-4e31-8639-b579c8f1c50b/download/gsp_regions_20220314.geojson"
	success, api_response = utils.fetch_from_api(
	eso_url, proxies=self.proxies, ssl_verify=self.ssl_verify
	)
	if success:
	raw = json.loads(api_response.text)
	gsp_regions = gpd.GeoDataFrame.from_features(
	raw["features"], crs=raw["crs"]["properties"]["name"]
	)
	gsp_regions.geometry = gsp_regions.buffer(0)
	else:
	raise utils.GenericException(
	"Encountered an error while extracting GSP region data from ESO " "API."
	)
	self.cache_manager.write(self.gsp_boundaries_20220314_cache_file, gsp_regions)
	logging.info(
	"20220314 GSP boundaries extracted and pickled to '%s'",
	self.gsp_boundaries_20220314_cache_file,
	)
	return gsp_regions

And for loading GSP boundaries version 20250109:

Geocode/geocode/neso.py

Lines 98 to 145 in 6e7ce40

	def _load_gsp_boundaries_20250109(self):
	"""
	Load the 20250109 GSP / GNode boundaries, either from local cache if available, else fetch
	from ESO Data Portal API.
	Returns
	-------
	gsp_regions: GeoPandas.GeoDataFrame
	A geodataframe of MultiPolygons for the GSP boundaries.
	"""
	gsp_boundaries_cache_contents = self.cache_manager.retrieve(
	self.gsp_boundaries_20250109_cache_file
	)
	if gsp_boundaries_cache_contents is not None:
	logging.debug(
	"Loading 20250109 GSP boundaries from cache ('%s')",
	self.gsp_boundaries_20250109_cache_file,
	)
	return gsp_boundaries_cache_contents
	logging.info(
	"Extracting the 20250109 GSP boundary data from NESO's Data Portal API (this "
	"only needs to be done once)"
	)
	eso_url = "https://api.neso.energy/dataset/2810092e-d4b2-472f-b955-d8bea01f9ec0/resource/d95e8c1b-9cd9-41dd-aacb-4b53b8c07c20/download/gsp_regions_20250109.zip"
	success, api_response = utils.fetch_from_api(
	eso_url, proxies=self.proxies, ssl_verify=self.ssl_verify
	)
	if success:
	zip_file = io.BytesIO(api_response.content)
	target_file = "Proj_27700/GSP_regions_27700_20250109.geojson"
	with ZipFile(zip_file, "r") as zip_ref:
	if target_file in zip_ref.namelist():
	with zip_ref.open(target_file) as file:
	raw = json.loads(file.read())
	gsp_regions = gpd.GeoDataFrame.from_features(
	raw["features"], crs=raw["crs"]["properties"]["name"]
	)
	gsp_regions.geometry = gsp_regions.buffer(0)
	else:
	raise utils.GenericException(
	"Encountered an error while extracting GSP region data from ESO " "API."
	)
	self.cache_manager.write(self.gsp_boundaries_20250109_cache_file, gsp_regions)
	logging.info(
	"20250109 GSP boundaries extracted and pickled to '%s'",
	self.gsp_boundaries_20250109_cache_file,
	)
	return gsp_regions