{"openapi":"3.1.0","info":{"title":"Location Profile API","description":"**Level 1** — Single-pixel elevation (all tiers).\n\n**Level 2** — Neighbourhood stats & charts (Pro/Enterprise).\n\n**Level 3** — Terrain maps (Pro/Enterprise).\n\nAll requests require `X-API-Key` header.","version":"3.0.0"},"paths":{"/datasets":{"get":{"tags":["Catalogue"],"summary":"List Datasets","operationId":"list_datasets_datasets_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/lp/elevation":{"get":{"tags":["Level 1 — Pixel"],"summary":"Lp Get Elevation","description":"**LP_Get_Elevation** — elevation in metres at (lat, lon). Free tier.","operationId":"lp_get_elevation_lp_elevation_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"lat","in":"query","required":true,"schema":{"type":"number","maximum":90,"minimum":-90,"title":"Lat"}},{"name":"lon","in":"query","required":true,"schema":{"type":"number","maximum":180,"minimum":-180,"title":"Lon"}},{"name":"dataset_id","in":"query","required":true,"schema":{"type":"string","title":"Dataset Id"}},{"name":"api_key","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Api Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["Level 1 — Pixel"],"summary":"Lp Post Elevation","description":"**LP_Get_Elevation** — POST version. Free tier.","operationId":"lp_post_elevation_lp_elevation_post","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"api_key","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Api Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LPBaseRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/lp/elevation/batch":{"post":{"tags":["Level 1 — Pixel"],"summary":"Lp Elevation Batch","description":"**LP_Elevation_Batch** — up to 100 points. Free tier.","operationId":"lp_elevation_batch_lp_elevation_batch_post","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"api_key","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Api Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LPBatchRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/lp/elevation_stats":{"get":{"tags":["Level 2 — Neighbourhood"],"summary":"Lp Get Elevation Stats","description":"**LP_Get_Elevation_Stats** — Min/Avg/Max for 3×3, 5×5, 7×7 windows. Pro.","operationId":"lp_get_elevation_stats_lp_elevation_stats_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"lat","in":"query","required":true,"schema":{"type":"number","maximum":90,"minimum":-90,"title":"Lat"}},{"name":"lon","in":"query","required":true,"schema":{"type":"number","maximum":180,"minimum":-180,"title":"Lon"}},{"name":"dataset_id","in":"query","required":true,"schema":{"type":"string","title":"Dataset Id"}},{"name":"api_key","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Api Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["Level 2 — Neighbourhood"],"summary":"Lp Post Elevation Stats","operationId":"lp_post_elevation_stats_lp_elevation_stats_post","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"api_key","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Api Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LPBaseRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/lp/slope_stats":{"get":{"tags":["Level 2 — Neighbourhood"],"summary":"Lp Get Slope Stats","description":"**LP_Get_Slope_Stats** — slope stats for 3×3, 5×5, 7×7 windows. Pro.","operationId":"lp_get_slope_stats_lp_slope_stats_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"lat","in":"query","required":true,"schema":{"type":"number","maximum":90,"minimum":-90,"title":"Lat"}},{"name":"lon","in":"query","required":true,"schema":{"type":"number","maximum":180,"minimum":-180,"title":"Lon"}},{"name":"dataset_id","in":"query","required":true,"schema":{"type":"string","title":"Dataset Id"}},{"name":"api_key","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Api Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["Level 2 — Neighbourhood"],"summary":"Lp Post Slope Stats","operationId":"lp_post_slope_stats_lp_slope_stats_post","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"api_key","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Api Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LPBaseRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/lp/elevation_chart":{"get":{"tags":["Level 2 — Neighbourhood"],"summary":"Lp Get Elevation Chart","description":"**LP_Get_Elevation_Chart** — elevation range-box chart. Pro. PNG/SVG/PDF.","operationId":"lp_get_elevation_chart_lp_elevation_chart_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"lat","in":"query","required":true,"schema":{"type":"number","maximum":90,"minimum":-90,"title":"Lat"}},{"name":"lon","in":"query","required":true,"schema":{"type":"number","maximum":180,"minimum":-180,"title":"Lon"}},{"name":"dataset_id","in":"query","required":true,"schema":{"type":"string","title":"Dataset Id"}},{"name":"fmt","in":"query","required":false,"schema":{"type":"string","default":"png","title":"Fmt"}},{"name":"api_key","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Api Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["Level 2 — Neighbourhood"],"summary":"Lp Post Elevation Chart","operationId":"lp_post_elevation_chart_lp_elevation_chart_post","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"api_key","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Api Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LPChartRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/lp/slope_chart":{"get":{"tags":["Level 2 — Neighbourhood"],"summary":"Lp Get Slope Chart","description":"**LP_Get_Slope_Chart** — slope range-box chart. Pro. PNG/SVG/PDF.","operationId":"lp_get_slope_chart_lp_slope_chart_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"lat","in":"query","required":true,"schema":{"type":"number","maximum":90,"minimum":-90,"title":"Lat"}},{"name":"lon","in":"query","required":true,"schema":{"type":"number","maximum":180,"minimum":-180,"title":"Lon"}},{"name":"dataset_id","in":"query","required":true,"schema":{"type":"string","title":"Dataset Id"}},{"name":"fmt","in":"query","required":false,"schema":{"type":"string","default":"png","title":"Fmt"}},{"name":"api_key","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Api Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["Level 2 — Neighbourhood"],"summary":"Lp Post Slope Chart","operationId":"lp_post_slope_chart_lp_slope_chart_post","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"api_key","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Api Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LPChartRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/lp/terrain_map":{"get":{"tags":["Level 3 — Area Maps"],"summary":"Lp Get Terrain Map","description":"**LP_Get_Terrain_Map** — satellite + contours + flow arrows. Pro. PNG/SVG/PDF.","operationId":"lp_get_terrain_map_lp_terrain_map_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"lat","in":"query","required":true,"schema":{"type":"number","maximum":90,"minimum":-90,"title":"Lat"}},{"name":"lon","in":"query","required":true,"schema":{"type":"number","maximum":180,"minimum":-180,"title":"Lon"}},{"name":"dataset_id","in":"query","required":true,"schema":{"type":"string","title":"Dataset Id"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","maximum":50,"minimum":10,"default":20,"title":"Offset"}},{"name":"contour_interval","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Contour Interval"}},{"name":"n_arrows","in":"query","required":false,"schema":{"type":"integer","maximum":11,"minimum":11,"default":11,"title":"N Arrows"}},{"name":"slope_threshold","in":"query","required":false,"schema":{"type":"number","maximum":5,"minimum":0.5,"default":1.0,"title":"Slope Threshold"}},{"name":"fmt","in":"query","required":false,"schema":{"type":"string","default":"png","title":"Fmt"}},{"name":"api_key","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Api Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["Level 3 — Area Maps"],"summary":"Lp Post Terrain Map","operationId":"lp_post_terrain_map_lp_terrain_map_post","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"api_key","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Api Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LPTerrainMapRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/lp/terrain_3d":{"get":{"tags":["Level 3 — Area Maps"],"summary":"Lp Get Terrain 3D","description":"**LP_Get_Terrain_3D** — 3-D perspective surface. Pro. PNG/SVG/PDF.","operationId":"lp_get_terrain_3d_lp_terrain_3d_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"lat","in":"query","required":true,"schema":{"type":"number","maximum":90,"minimum":-90,"title":"Lat"}},{"name":"lon","in":"query","required":true,"schema":{"type":"number","maximum":180,"minimum":-180,"title":"Lon"}},{"name":"dataset_id","in":"query","required":true,"schema":{"type":"string","title":"Dataset Id"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","maximum":50,"minimum":10,"default":20,"title":"Offset"}},{"name":"elev_angle","in":"query","required":false,"schema":{"type":"number","maximum":80,"minimum":5,"default":45,"title":"Elev Angle"}},{"name":"azim_angle","in":"query","required":false,"schema":{"type":"number","maximum":360,"minimum":0,"default":135,"title":"Azim Angle"}},{"name":"fmt","in":"query","required":false,"schema":{"type":"string","default":"png","title":"Fmt"}},{"name":"api_key","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Api Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["Level 3 — Area Maps"],"summary":"Lp Post Terrain 3D","operationId":"lp_post_terrain_3d_lp_terrain_3d_post","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"api_key","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Api Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LPTerrain3DRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"LPBaseRequest":{"properties":{"lat":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Lat"},"lon":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Lon"},"dataset_id":{"type":"string","title":"Dataset Id"}},"type":"object","required":["lat","lon","dataset_id"],"title":"LPBaseRequest"},"LPBatchItem":{"properties":{"lat":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Lat"},"lon":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Lon"},"dataset_id":{"type":"string","title":"Dataset Id"},"band":{"type":"integer","title":"Band","default":1}},"type":"object","required":["lat","lon","dataset_id"],"title":"LPBatchItem"},"LPBatchRequest":{"properties":{"queries":{"items":{"$ref":"#/components/schemas/LPBatchItem"},"type":"array","maxItems":100,"title":"Queries"}},"type":"object","required":["queries"],"title":"LPBatchRequest"},"LPChartRequest":{"properties":{"lat":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Lat"},"lon":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Lon"},"dataset_id":{"type":"string","title":"Dataset Id"},"fmt":{"type":"string","title":"Fmt","default":"png"}},"type":"object","required":["lat","lon","dataset_id"],"title":"LPChartRequest"},"LPTerrain3DRequest":{"properties":{"lat":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Lat"},"lon":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Lon"},"dataset_id":{"type":"string","title":"Dataset Id"},"offset":{"type":"integer","maximum":50.0,"minimum":10.0,"title":"Offset","default":20},"elev_angle":{"type":"number","maximum":80.0,"minimum":5.0,"title":"Elev Angle","default":45.0},"azim_angle":{"type":"number","maximum":360.0,"minimum":0.0,"title":"Azim Angle","default":135.0},"fmt":{"type":"string","title":"Fmt","default":"png"}},"type":"object","required":["lat","lon","dataset_id"],"title":"LPTerrain3DRequest"},"LPTerrainMapRequest":{"properties":{"lat":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Lat"},"lon":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Lon"},"dataset_id":{"type":"string","title":"Dataset Id"},"offset":{"type":"integer","maximum":50.0,"minimum":10.0,"title":"Offset","default":20},"contour_interval":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Contour Interval"},"n_arrows":{"type":"integer","maximum":60.0,"minimum":5.0,"title":"N Arrows","default":11},"slope_threshold":{"type":"number","maximum":5.0,"minimum":0.5,"title":"Slope Threshold","default":1.0},"fmt":{"type":"string","title":"Fmt","default":"png"}},"type":"object","required":["lat","lon","dataset_id"],"title":"LPTerrainMapRequest"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}},"securitySchemes":{"APIKeyHeader":{"type":"apiKey","in":"header","name":"X-API-Key"}}}}