---
title: "Get map image"
method: GET
path: "/map/{district_id}"
tags: ["Map"]
---

# Get map image

`GET /map/{district_id}`

Cicero makes simple maps of district boundaries available through the map resource.

Use the `id` property from a District object with this resource to request an image showing the shape of the district. The appearance of the map can be configured beyond the default style with graphical parameters.

JSON and XML responses will contain the image as a data URI. Requests with format=image will return only the image.

Cost: 1 credit

## Path parameters

- `district_id` number, required

## Query parameters

- `format` 'json' | 'xml'
- `customer_id` string, password, required
- `key` string, password
- `width` number
- `height` number
- `fill_color` string
- `fill_opacity` string
- `boundary_width` number
- `boundary_color` number
- `boundary_line_join` string
- `map_format` 'png' | 'png8' | 'png32' | 'png256' | 'jpeg'
- `srs` string

## Headers

- `Accept` 'application/json' | '*/*', required
- `Content-Type` 'application/json' | 'application/xml', required

## Response `200`

Successful response

- object
  - `response` ResponseMap
    - `errors` unknown[] — If the request encountered an error or errors, details about the error(s) will be contained in this field.
      - unknown
    - `messages` unknown[] — Contains the resources matching the request query, if any.
      - unknown
    - `results` object — Contains additional information about the outcome of a request that is not an error and not part of a query result.
      - `maps` MapObject[]
        - `extent` object
          - `x_min` number
          - `x_max` number
          - `y_min` number
          - `y_max` number
          - `srid` number
        - `img_src` string

## Other responses

- `400` — Bad Request

---

[API](https://skmtc.net/melissa/apis/cicero.md) · [All operations](https://skmtc.net/melissa/apis/cicero/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/melissa/cicero/versions/34d86f140b3f/schema)