GTC-3172: Support GADM areas in drivers endpoints

[gtempus]

Pull request checklist

Please check if your PR fulfills the following requirements:

• Make sure you are requesting to pull a topic/feature/bugfix branch (right side). Don't request your master!
• Make sure you are making a pull request against the develop branch (left side). Also you should start your branch off our develop.
• Check the commit's or even all commits' message styles matches our requested structure.
• Check your code additions will fail neither code linting checks nor unit test.

Pull request type

Please check the type of change your PR introduces:

• Bugfix
• Feature
• Code style update (formatting, renaming)
• Refactoring (no functional changes, no api changes)
• Build related changes
• Documentation content changes
• Other (please describe):

What is the current behavior?

Administrative boundary areas are not supported. The client must have a geostore ID

Issue Number: GTC-3172

What is the new behavior?

Clients can now use Administrative Boundaries with requests.

GET (query parameters):
aoi[type]=admin&aoi[country]=BRA&aoi[region]=12&aoi[subregion]=23

POST (body):

{
  "aoi": {
    "type": "admin",
    "country": "BRA",
    "region": "12",
    "subregion": "23"
  }
}

NOTE

There is now a grouping parameter (aoi) and a discriminator (aoi[type])
The discriminator makes for very nice openapi documentation and allows much richer validation for pydantic unions
https://docs.pydantic.dev/latest/concepts/unions/#discriminated-unions

Only GADM 4.1 is currently supported

Does this introduce a breaking change?

• Yes
• No

[codecov-commenter]

⚠️ Please install the to ensure uploads and comments are reliably processed by Codecov.

Codecov Report

Attention: Patch coverage is 40.20619% with 58 lines in your changes missing coverage. Please review.

Project coverage is 77.29%. Comparing base (0e6cc35) to head (7cd6d1b).

Files with missing lines	Patch %	Lines
app/routes/datamart/land.py	17.24%	24 Missing ⚠️
app/crud/geostore.py	21.42%	22 Missing ⚠️
app/models/pydantic/datamart.py	69.23%	12 Missing ⚠️

❗ Your organization needs to install the Codecov GitHub app to enable full functionality.

Additional details and impacted files

@@             Coverage Diff             @@
##           develop     #656      +/-   ##
===========================================
- Coverage    77.57%   77.29%   -0.28%     
===========================================
  Files          142      143       +1     
  Lines         6528     6593      +65     
===========================================
+ Hits          5064     5096      +32     
- Misses        1464     1497      +33     

Flag	Coverage Δ
unittests	77.29% <40.20%> (-0.28%)	⬇️

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

[dmannarino]

In general this looks good! Holding off approving due to the simplification question. Also I think there's a little linting that went awry (either that or my knowledge of standards is out of date). Would you mind trying to run the pre-commit hooks on the involved files again?

[solomon-negusse]

One last comment: I feel CustomAreaOfInterest or UserAreaOfInterest may be more fitting name for the public facing doc

[gtempus]

I personally feel that those are too vague. But I'd like to hear what other folks think.
CC @jterry64 @dmannarino

[gtempus]

@dmannarino, I ran the pre-commit hook in this commit: 6193fc5

[danscales]

Just a number of minor comments. Looks good.