---
title: geo.s2CellIDToken() function
description: geo.s2CellIDToken() returns and S2 cell ID token for given cell or point at a specified S2 cell level.
url: https://docs.influxdata.com/flux/v0/stdlib/experimental/geo/s2cellidtoken/
estimated_tokens: 1407
product: Flux
version: v0
publisher: InfluxData
canonical: https://docs.influxdata.com/flux/v0/stdlib/experimental/geo/s2cellidtoken/
date: '2024-04-08T16:01:02-06:00'
lastmod: '2024-04-08T16:01:02-06:00'
---

* Flux 0.64.0+

InfluxDB support

> [!Important]
> `geo.s2CellIDToken()` is experimental and [subject to change at any time](/flux/v0/stdlib/experimental/#experimental-packages-are-subject-to-change).

`geo.s2CellIDToken()` returns and S2 cell ID token for given cell or point at a
specified S2 cell level.

##### Function type signature

```js
(level: int, ?point: {lon: float, lat: float}, ?token: string) => string
```

For more information, see [Function type signatures](/flux/v0/function-type-signatures/).

## Parameters

### token

S2 cell ID token to update.

Useful for changing the S2 cell level of an existing S2 cell ID token.

### point

Record with `lat` and `lon` properties that specify the latitude and
longitude in decimal degrees (WGS 84) of a point.

### level

(Required)
S2 cell level to use when generating the S2 cell ID token.

## Examples

* [Use latitude and longitude values to generate S2 cell ID tokens](#use-latitude-and-longitude-values-to-generate-s2-cell-id-tokens)
* [Update S2 cell ID token level](#update-s2-cell-id-token-level)

### Use latitude and longitude values to generate S2 cell ID tokens

```js
import "experimental/geo"

data
    |> map(
        fn: (r) =>
            ({r with s2_cell_id: geo.s2CellIDToken(point: {lat: r.lat, lon: r.lon}, level: 10)}),
    )
```

[](#view-example-input-and-output)

View example input and output

#### Input data

|       \_time       |\*id |  lon  |  lat   |
|--------------------|-----|-------|--------|
|2021-01-01T00:00:00Z|a213b|39.7515|14.01433|
|2021-01-02T01:00:00Z|a213b|38.3527|13.9228 |
|2021-01-03T02:00:00Z|a213b|36.9978|15.08433|

|       \_time       |\*id |  lon  |   lat   |
|--------------------|-----|-------|---------|
|2021-01-01T00:00:00Z|b546c|24.0069|\-14.5464|
|2021-01-02T01:00:00Z|b546c|25.1304|\-13.3338|
|2021-01-03T02:00:00Z|b546c|26.7899|\-12.0433|

#### Output data

|       \_time       |\*id |  lat   |  lon  |s2\_cell\_id|
|--------------------|-----|--------|-------|------------|
|2021-01-01T00:00:00Z|a213b|14.01433|39.7515|   166b59   |
|2021-01-02T01:00:00Z|a213b|13.9228 |38.3527|   16696d   |
|2021-01-03T02:00:00Z|a213b|15.08433|36.9978|   166599   |

|       \_time       |\*id |   lat   |  lon  |s2\_cell\_id|
|--------------------|-----|---------|-------|------------|
|2021-01-01T00:00:00Z|b546c|\-14.5464|24.0069|   1960d7   |
|2021-01-02T01:00:00Z|b546c|\-13.3338|25.1304|   1965c7   |
|2021-01-03T02:00:00Z|b546c|\-12.0433|26.7899|   1971dd   |

### Update S2 cell ID token level

```js
import "experimental/geo"

data
    |> map(fn: (r) => ({r with s2_cell_id: geo.s2CellIDToken(token: r.s2_cell_id, level: 5)}))
```

[](#view-example-input-and-output)

View example input and output

#### Input data

|       \_time       |\*id |s2\_cell\_id|
|--------------------|-----|------------|
|2021-01-01T00:00:00Z|a213b|   166b59   |
|2021-01-02T01:00:00Z|a213b|   16696d   |
|2021-01-03T02:00:00Z|a213b|   166599   |

|       \_time       |\*id |s2\_cell\_id|
|--------------------|-----|------------|
|2021-01-01T00:00:00Z|b546c|   1960d7   |
|2021-01-02T01:00:00Z|b546c|   1965c7   |
|2021-01-03T02:00:00Z|b546c|   1971dd   |

#### Output data

|       \_time       |\*id |s2\_cell\_id|
|--------------------|-----|------------|
|2021-01-01T00:00:00Z|a213b|    166c    |
|2021-01-02T01:00:00Z|a213b|    166c    |
|2021-01-03T02:00:00Z|a213b|    1664    |

|       \_time       |\*id |s2\_cell\_id|
|--------------------|-----|------------|
|2021-01-01T00:00:00Z|b546c|    1964    |
|2021-01-02T01:00:00Z|b546c|    1964    |
|2021-01-03T02:00:00Z|b546c|    1974    |

#### Related

* [Work with geo-temporal data](/influxdb/v2/query-data/flux/geo/)

[geotemporal](/flux/v0/tags/geotemporal/)
| _time | *id | lon | lat |
| --- | --- | --- | --- |
| _time | *id | lon | lat |
| 2021-01-01T00:00:00Z | a213b | 39.7515 | 14.01433 |
| 2021-01-02T01:00:00Z | a213b | 38.3527 | 13.9228 |
| 2021-01-03T02:00:00Z | a213b | 36.9978 | 15.08433 |

| _time | *id | lon | lat |
| --- | --- | --- | --- |
| _time | *id | lon | lat |
| 2021-01-01T00:00:00Z | b546c | 24.0069 | -14.5464 |
| 2021-01-02T01:00:00Z | b546c | 25.1304 | -13.3338 |
| 2021-01-03T02:00:00Z | b546c | 26.7899 | -12.0433 |

| _time | *id | lat | lon | s2_cell_id |
| --- | --- | --- | --- | --- |
| _time | *id | lat | lon | s2_cell_id |
| 2021-01-01T00:00:00Z | a213b | 14.01433 | 39.7515 | 166b59 |
| 2021-01-02T01:00:00Z | a213b | 13.9228 | 38.3527 | 16696d |
| 2021-01-03T02:00:00Z | a213b | 15.08433 | 36.9978 | 166599 |

| _time | *id | lat | lon | s2_cell_id |
| --- | --- | --- | --- | --- |
| _time | *id | lat | lon | s2_cell_id |
| 2021-01-01T00:00:00Z | b546c | -14.5464 | 24.0069 | 1960d7 |
| 2021-01-02T01:00:00Z | b546c | -13.3338 | 25.1304 | 1965c7 |
| 2021-01-03T02:00:00Z | b546c | -12.0433 | 26.7899 | 1971dd |

| _time | *id | s2_cell_id |
| --- | --- | --- |
| _time | *id | s2_cell_id |
| 2021-01-01T00:00:00Z | a213b | 166b59 |
| 2021-01-02T01:00:00Z | a213b | 16696d |
| 2021-01-03T02:00:00Z | a213b | 166599 |

| _time | *id | s2_cell_id |
| --- | --- | --- |
| _time | *id | s2_cell_id |
| 2021-01-01T00:00:00Z | b546c | 1960d7 |
| 2021-01-02T01:00:00Z | b546c | 1965c7 |
| 2021-01-03T02:00:00Z | b546c | 1971dd |

| _time | *id | s2_cell_id |
| --- | --- | --- |
| _time | *id | s2_cell_id |
| 2021-01-01T00:00:00Z | a213b | 166c |
| 2021-01-02T01:00:00Z | a213b | 166c |
| 2021-01-03T02:00:00Z | a213b | 1664 |

| _time | *id | s2_cell_id |
| --- | --- | --- |
| _time | *id | s2_cell_id |
| 2021-01-01T00:00:00Z | b546c | 1964 |
| 2021-01-02T01:00:00Z | b546c | 1964 |
| 2021-01-03T02:00:00Z | b546c | 1974 |