> ## Documentation Index
> Fetch the complete documentation index at: https://api-docs.iklim.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Geometri Sorgusu

> Belirtilen yağış olaylarının geometrisini, verilen dairesel alana göre keserek protobuf formatında döndürür. Power user ve üstü role sahip kullanıcılar merkez nokta ve yarıçap belirtmeksizin geometriyi kesmeden sorgulayabilir.



## OpenAPI

````yaml /open-api/tr/precipitations_version-1.json post /v1/precipitations/geometry
openapi: 3.1.0
info:
  title: OpenAPI definition
  version: v0
servers:
  - url: https://api.iklim.co
    description: Production server
  - url: https://api-test.iklim.co
    description: Test server
security: []
tags:
  - name: Yağış Hizmeti
    description: Yağış verilerini sorgulamak için kullanılan endpoint'ler.
paths:
  /v1/precipitations/geometry:
    post:
      tags:
        - Yağış Hizmeti
      summary: Geometri Sorgusu
      description: >-
        Belirtilen yağış olaylarının geometrisini, verilen dairesel alana göre
        keserek protobuf formatında döndürür. Power user ve üstü role sahip
        kullanıcılar merkez nokta ve yarıçap belirtmeksizin geometriyi kesmeden
        sorgulayabilir.
      operationId: getGeometryByEventIds
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PrecipitationsGeometryRequest'
        required: true
      responses:
        '200':
          description: İstenen yağış olaylarının kesilmiş geometrisi başarıyla getirildi.
          content:
            application/json:
              schema:
                type: string
                format: byte
                description: >-
                  İstenen olayların kesilmiş çokgen geometrilerini içeren
                  protobuf kodlu FeatureCollection.
        '400':
          description: Bad Request
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/StandardErrorResponse'
        '401':
          description: Unauthorized
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/StandardErrorResponse'
        '402':
          description: Ücretli Abonelik Gerekli
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StandardErrorResponse'
              examples:
                Payment Required:
                  summary: Example response
                  description: Payment Required
                  value:
                    timestamp: '2025-06-25T11:15:41.429518242'
                    status: 402
                    error: Payment Required
                    message: You Need To Renew Your Subscription or Purchase New One
                    path: /v1/precipitations/within
        '403':
          description: Yasak/İzin Verilmiyor
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StandardErrorResponse'
              examples:
                No Subscription Found For This Service Endpoint:
                  summary: Missing Subscription
                  description: No Subscription Found For This Service Endpoint
                  value:
                    timestamp: '2025-06-25T11:21:50.510755746'
                    status: 403
                    error: Forbidden
                    message: No Subscription Found For This Service Endpoint
                    path: /v1/precipitations/within
                This Location Is Not In Allowed Geographic Boundaries:
                  summary: Out of Allowed Geographic Boundaries
                  description: This Location Is Not In Allowed Geographic Boundaries
                  value:
                    timestamp: '2025-06-25T15:59:19.452326857'
                    status: 403
                    error: Forbidden
                    message: >-
                      The Location You Are Querying [dd.ddddd, dd.ddddd] Is Not
                      Within The Geographic Boundaries Allowed In Your
                      Subscription [Country, Region]
                    path: /v1/precipitations/within
        '429':
          description: Bu Hizmet İçin Abonelik Limitleri Aşıldı
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StandardErrorResponse'
              examples:
                Too Many Requests:
                  summary: Example response
                  description: Too Many Requests
                  value:
                    timestamp: '2025-06-25T11:02:12.653874655'
                    status: 429
                    error: Too Many Requests
                    message: Your Subscription Limits For This Service is Exceeded
                    path: /v1/precipitations/within
        '500':
          description: İstek Sırasında Dahili Sunucu Hatası
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StandardErrorResponse'
              examples:
                Internal Server Error Example:
                  summary: Example response
                  description: Internal Server Error Example
                  value:
                    timestamp: '2025-04-14T16:58:10.414972912'
                    status: 500
                    error: Internal Server Error
                    message: An Error Occurred During Invocation
                    path: /endpoint/uri/here
components:
  schemas:
    PrecipitationsGeometryRequest:
      type: object
      properties:
        eventIds:
          type: array
          description: >-
            Geometrisi getirilecek yağış olay kimliklerinin listesi. En fazla 10
            öğe.
          example:
            - 69baa6b76e0fe76a1957273f
          items:
            type: string
          maxItems: 10
          minItems: 0
        center:
          $ref: '#/components/schemas/GeoPoint'
          description: >-
            Geometriyi kesmek için kullanılan daire merkezinin enlem/boylam
            koordinatları.
        radius:
          type: number
          format: double
          description: >-
            Geometriyi kesmek için kullanılan daire sınırının yarıçapı. Değer
            metre cinsinden verilmelidir (örn. 25000 = 25 km). En fazla 200
            kilometre (200000 metre).
          example: 1000
      required:
        - eventIds
    StandardErrorResponse:
      type: object
      description: Standart API hata cevabı yapısı
      properties:
        timestamp:
          type: string
          format: date-time
          description: Hatanın oluştuğu zaman damgası
          example: YYYY-mm-DDTHH:MM:SS.nnnnnnnnn
        status:
          type: integer
          format: int32
          description: HTTP durum kodu
          example: XXX
        error:
          type: string
          description: Hata adı veya tipi
          example: Error Name
          minLength: 1
        message:
          type: string
          description: Ana hata mesajı
          example: Error Message
          minLength: 1
        messages:
          type: array
          description: Ek detaylı hata mesajları
          items:
            type: string
        path:
          type: string
          description: Hatanın oluştuğu istek yolu
          example: /endpoint/uri/here
          minLength: 1
      required:
        - error
        - message
        - path
        - status
        - timestamp
    GeoPoint:
      type: object
      properties:
        lng:
          type: number
          format: double
          description: Boylam koordinatı.
          example: 32.857358
          maximum: 180
          minimum: -180
        lat:
          type: number
          format: double
          description: Enlem koordinatı.
          example: 39.93504
          maximum: 90
          minimum: -90
      required:
        - lat
        - lng

````