{"uid":"cap_4gEffQM1BDvtWH1Ht1gPf","slug":"halowerk-southern-land-spain-surface-aspect-94377f5f","name":"HALOWERK Southern Land – Spain Surface Aspect","description":"Circular direction of the dominant surface gradient, clockwise from north. The coordinate is validated against the Natural Earth boundary for Spain; results outside it are rejected before payment.","url":"https://suedland.halowerk.com/v1/es-aspect","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"latitude":{"type":"number","maximum":72.5,"minimum":34,"description":"WGS84 latitude inside the published European coverage."},"longitude":{"type":"number","maximum":40.5,"minimum":-31.5,"description":"WGS84 longitude inside the published European coverage."}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_136FsZSaugnS8faAXh80S","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the circular direction (0–360°, clockwise from north) of the dominant surface gradient for a given coordinate within Spain.","exampleAgentPrompt":"What direction does the terrain surface face at latitude 37.8 and longitude -4.2 in Spain — give me the aspect angle in degrees clockwise from north.","exampleUseCases":[{"title":"Solar farm site suitability check","prompt":"I'm evaluating a plot near Seville at latitude 37.35, longitude -5.98 — can you tell me the aspect angle of the terrain there so I can assess whether it gets good southward sun exposure?"},{"title":"Vineyard slope orientation assessment","prompt":"I need to know which direction the hillside faces at my vineyard site in La Rioja, coordinates latitude 42.46, longitude -2.51 — give me the dominant surface gradient direction in degrees."},{"title":"Erosion risk mapping for farmland","prompt":"For the agricultural parcel at latitude 41.1, longitude -0.9 in Aragon, what is the surface aspect angle? I need it to model which way water runoff flows across the slope."}],"resultDescription":"A numeric value representing the dominant surface aspect angle in degrees (0–360°, clockwise from north) for the queried coordinate within Spain. Coordinates outside the Spain boundary are rejected before any charge is applied.","failureModes":["Coordinate outside Spain boundary: request rejected before payment, error response indicating out-of-coverage area","Latitude or longitude outside the accepted WGS84 range for European coverage: validation error","Malformed input (missing or non-numeric lat/lon): schema validation error","Network or service timeout: no result returned, retry recommended","Edge case flat terrain with no dominant gradient: may return null or undefined aspect"],"whenToPreferThis":"Choose this endpoint when you need terrain aspect (slope direction) data specifically for coordinates within Spain, and require pre-query geographic validation to avoid wasted calls. Ideal for land suitability analysis, solar orientation assessments, agricultural planning, hydrological modelling, or any use case where knowing which compass direction a slope faces is critical.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T13:15:15.000Z","isFirstParty":false}