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

# Get ortophotos by property UUID

> Gets available ortophotos by authority UUID

Get a list of all high-resolution orthophotos for each year. We will automatically mark
the property areas and their boundary and enhance image quality for displaying directly in a web application.

The response will include the open URL or reduced image URL to the high resolution image which you can directly reference.
Please note that typical response times are 50-100 ms per image for areas up to \~100 000 m2 so make sure your request doesn't time out since a response could contain
up to 10 years of high-resolutions images (expect 1-3 seconds of non cached images).

<Warning>
  This endpoint will only serve images up to 2 000 000 m² and for very large
  areas response times can vary between 5-15 seconds per image (expect 45 - 90
  seconds response times).
</Warning>

Response will include a URL, url, representing loseless PNG which can be expected to be significant of size for large areas. We also
include a reduced version, urlReduced, in JPEG format (compressed) and images exceeding 2500 px in width will be resized to 2500 px
to avoid very large image sizes.

We recommend using the urlReduced for small displays and only use the full loselsess PNG for situations where you may need
the full details. Also included is the file sizes in byte for fileNameLength (url) and fileNameReducedLength (urlReduced). These
can help to make simple checks if you want to display the PNG or the JPEG image.

### Example

This example shows a retrieved image for the property, UMEÅ AMERIKA 1:1, having an area of 1 068 479 m² (large)
and the image rendered represents urlReduced e.g a compressed version in JPEG format. File size is \~2.3MB since it has been reduced to maximum 2500px in width (2500 x 1814px).

If you switch the URL extension to PNG (e.g [https://storage.tic.io/909a6a85-299b-90ec-e040-ed8f66444c3f\_2024\_32098.png](https://storage.tic.io/909a6a85-299b-90ec-e040-ed8f66444c3f_2024_32098.png))
you will get the full uncompressed and unmodified size of 12619 x 9156 px. The file size is now \~237MB.

![Example of a property 1 068 479 m²](https://storage.tic.io/909a6a85-299b-90ec-e040-ed8f66444c3f_2024_32098.jpg)

### Recommendations

Recommendation is to use an if-statement to check if the fileNameLength is less than 10000000 (10MB) and
display the url and if it's greater than 10000000 display the urlReduced.


## OpenAPI

````yaml get /datasets/properties/se/{uuid}/orthophotos
openapi: 3.0.4
info:
  title: TIC API
  description: ''
  version: v1
servers:
  - url: https://api.tic.io/
security:
  - ApiKey: []
tags:
  - name: BolagsverketStatistics
  - name: Companies
  - name: Companies_SE_
  - name: DocumentDelivery
  - name: EuropeanCommission
  - name: FinancialDocuments
  - name: Finansinspektionen
  - name: Free
  - name: ICA
  - name: ICAStatistics
  - name: Lists
  - name: Media
  - name: Persons
  - name: Persons_SE_
  - name: Properties_SE_
  - name: PTSPortings
  - name: Reseller
  - name: SearchBankruptciesReports
  - name: SearchCompanies
  - name: SearchCompaniesReports
  - name: SearchCompanyWorkplaces
  - name: SearchPerson
  - name: SearchProperties_SE_
  - name: SearchVehicles
  - name: TeamDocumentOrders
  - name: Teams
  - name: User
  - name: Vehicles_SE_
  - name: WatchLists
paths:
  /datasets/properties/se/{uuid}/orthophotos:
    get:
      tags:
        - Properties_SE_
      summary: Get ortophotos by property UUID
      description: Gets available ortophotos by authority UUID
      operationId: GetOrthophotoByUUID
      parameters:
        - name: uuid
          in: path
          description: The unique identifier for the property
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: >-
                    #/components/schemas/Ormeo_Library_Lantmateriet_Dto_Lantmateriet_Orthophoto_Dto
components:
  schemas:
    Ormeo_Library_Lantmateriet_Dto_Lantmateriet_Orthophoto_Dto:
      type: object
      properties:
        lantmateriet_OrderImageFileId:
          type: integer
          format: int32
        flightYear:
          type: integer
          format: int32
          nullable: true
        flightAltitude:
          type: integer
          format: int32
          nullable: true
        resolution:
          type: number
          format: double
          nullable: true
        spectralType:
          type: string
          nullable: true
        fileName:
          type: string
          nullable: true
        fileNameLength:
          type: integer
          format: int64
        fileNameReduced:
          type: string
          nullable: true
        fileNameReducedLength:
          type: integer
          format: int64
        url:
          type: string
          nullable: true
          readOnly: true
        urlReduced:
          type: string
          nullable: true
          readOnly: true
        error:
          type: string
          nullable: true
        processingTimeMs:
          type: integer
          format: int64
          nullable: true
        fromCache:
          type: boolean
        flightRecordingStarted:
          type: string
          format: date-time
          nullable: true
        flightRecordingEnded:
          type: string
          format: date-time
          nullable: true
        totalArea:
          type: integer
          format: int32
        numberOfAreas:
          type: integer
          format: int32
      additionalProperties: false
  securitySchemes:
    ApiKey:
      type: apiKey
      name: x-api-key
      in: header

````