# High-Speed Binary Caching

Sub-second re-renders are achieved through a binary caching system using Go's `gob` format.

## Optimization

- **Binary Serialization**: Near-instant disk I/O compared to JSON or XML.

- **Nominatim Cache**: Stores geocoding results locally to respect rate limits.

- **Data Persistence**: Map data remains cached for future artistic iterations.

# Powerful CLI Automation

A tool for designers and developers alike. Fully automatable via command line.

## Basic Usage

```bash

./CartoGo.exe -city "Sydney" -country "Australia"

```

## Batch Processing

Easily scriptable to generate a collection of posters for entire countries or regions using simple shell loops.

# OpenStreetMap Data Pipeline

Fetching map data is handled by a specialized Overpass QL query engine.

## Pipeline Steps

1. **Query Building**: Dynamic BBox queries for roads, water, and greenery.

2. **Fetch & Retry**: Robust handling of API timeouts and server load.

3. **Relation Processing**: Complex multipolygon reconstruction for parks and lakes.

# Geocoding Integration

Precise location targeting via the Nominatim API.

## Features

- **Structured Search**: Targets specific cities and countries.

- **Centroid Calculation**: Uses geocoded coordinates as the map center.

- **Radius Tuning**: Allows users to zoom in or out from the geocoded point.

# High-Resolution Print Export

Engineered for the physical world. Export high-fidelity posters ready for professional printing.

## Print Specifications

- **300 DPI**: Standard professional print resolution.

- **Custom Dimensions**: Support for any size (A4, A3, 18x24, etc.).

- **Vector Parity**: Ensures sharp lines and smooth gradients on large scales.

{

"title": "CartoGo",

"subtitle": "Artistic City Mapping",

"description": "A high-performance Go implementation of the City Map Poster Generator. Generate beautiful, minimalist map posters for any city in the world with 1-to-1 aesthetic parity.",

"backgroundImage": "ankara.webp",

"credits": [

{ "role": "Technical Port & Optimization", "name": "Fezcode" },

{ "role": "Original Project Vision", "name": "Ankur Gupta (maptoposter)" }

],

"buttons": [

{ "label": "See Project", "link": "https://github.com/fezcode/CartoGo", "type": "primary" }

],

"stats": [

{ "value": "1ms", "label": "Cache Access" },

{ "value": "300", "label": "Target DPI" },

{ "value": "17", "label": "Design Themes" }

]

}

{

"logo": {

"label": "CartoGo",

"icon": "MapTrifold"

},

"links": [

{ "label": "Home", "link": "/" },

{ "label": "Projects", "link": "/projects" }

],

"cta": {

"label": "See Project",

"link": "https://github.com/fezcode/CartoGo",

"icon": "GithubLogo"

}

}

# CartoGo Overview

**CartoGo** is a high-performance Go implementation of the original City Map Poster Generator. It is designed for speed, reliability, and 1-to-1 aesthetic parity with the original Python project.

## Project Vision

To generate beautiful, minimalist map posters for any city in the world, leveraging the concurrency and safety of the Go programming language.

## Architecture

- **Language**: Go 1.25+

- **Graphics**: `gg` library

- **Data**: OpenStreetMap (Overpass API)

- **Geocoding**: Nominatim

# Concurrent Performance

Leveraging Go's Goroutines to accelerate the rendering pipeline.

## Go vs Python

- **Speed**: Significant performance uplift over Matplotlib rendering.

- **Type Safety**: Reduces bugs in coordinate transformation.

- **Distribution**: Compiles to a single static binary for easy use.