---
title: "Usage"
version: "main"
source: "Usage/Index.rst"
rendered: "2026-10-01T12:34:53+00:00"
---

# Usage {#usage}

## Tile-Proxy-Endpoint {#tile-proxy-endpoint}

With this extension you can define a page in the TYPO3 backend as an endpoint for maps.

If the slug for your page is e.g. tile-proxy, the data can be retrieved from:

```javascript
/tile-proxy/?provider=osm&z={z}&x={x}&y={y}&s={s}
```

### Arguments {#arguments}

**provider**

Currently only osm (OpenStreetMap) is supported, so the value must be osm.

**z**

zoom level ([https://wiki.openstreetmap.org/wiki/Slippy_map_tilenames](https://wiki.openstreetmap.org/wiki/Slippy_map_tilenames))

**x**

x-tile coordinate ([https://wiki.openstreetmap.org/wiki/Slippy_map_tilenames](https://wiki.openstreetmap.org/wiki/Slippy_map_tilenames))

**y**

y-tile coordinate ([https://wiki.openstreetmap.org/wiki/Slippy_map_tilenames](https://wiki.openstreetmap.org/wiki/Slippy_map_tilenames))

**s**

OSM subdomain for CDN

If the tile must be loaded and is not cached, this request will be mapped to:

```javascript
https://{s}.tile.openstreetmap.org/{z}/{x}/{y}.png
```

The http referrer must be your own domain, localhost or configured in page settings or extension configuration, otherwise you will receive error 1001.

#### Leaflet Example {#leaflet-example}

```javascript
// Initialize the base layer
L.tileLayer('/tile-proxy/?provider=osm&z={z}&x={x}&y={y}&s={s}', {
  attribution: '&#169; <a href="https://www.openstreetmap.org/copyright" target="_blank">OpenStreetMap</a> contributors',

}).addTo(map);
```

#### OpenLayer Example {#openlayer-example}

```javascript
var osmSource = new ol.source.XYZ({
    attributions : '&#169; <a href="https://www.openstreetmap.org/copyright" target="_blank">OpenStreetMap</a> contributors',
    urls: [
      '/tile-proxy/?provider=osm&z={z}&x={x}&y={y}&s=a',
      '/tile-proxy/?provider=osm&z={z}&x={x}&y={y}&s=b',
      '/tile-proxy/?provider=osm&z={z}&x={x}&y={y}&s=c',
    ]
});
```

## Nominatim-Proxy-Endpoint {#nominatim-proxy-endpoint}

With this extension you can define a page in the TYPO3 backend as an endpoint for geocoding request to nominatim.

If the slug for your page is e.g. geo-proxy, the data can be retrieved from:

```javascript
/geo-proxy/?provider=osm&apitype=search&q=06120&format=json&addressdetails=1
```

### Arguments {#arguments-1}

**provider**

Currently only osm (OpenStreetMap) is supported, so the value must be osm.

**apitype**

Type of the api endpoint.
Permissible types are: 'search','reverse','lookup'
see [https://nominatim.org/release-docs/latest/api/Overview/](https://nominatim.org/release-docs/latest/api/Overview/)

**all other paramers**

all other parameters are forwarded directly to the nominatim-api.

If the request must be loaded and is not cached, this request will be mapped to:

```javascript
https://nominatim.openstreetmap.org/search?q=06120&format=json&addressdetails=1
```

The http referrer must be your own domain, localhost or configured in page settings or extension configuration, otherwise you will receive error 1001.