---
title: "LocationEntity: CDEK cities and postal codes in Joomla | WT CDEK - WebTolk websites development, Joomla Extensions"
description: "LocationEntity for Joomla: cities, regions, postal codes and coordinates. WT CDEK documentation with CDEK API parameters and PHP integration examples."
url: "https://web-tolk.ru/en/dev/biblioteki/wt-cdek-library-for-joomla-developers/documentation/wt-cdek-entities-location"
date: "2026-11-02T12:19:05+00:00"
language: "en-GB"
---

## Breadcrumbs

[Home](https://web-tolk.ru/en) > [Joomla extensions](https://web-tolk.ru/en/dev) > [Libraries](/en/dev/biblioteki) > [WT CDEK library](/en/dev/biblioteki/wt-cdek-library-for-joomla-developers) > [Documentation](/en/dev/biblioteki/wt-cdek-library-for-joomla-developers/documentation) > LocationEntity: CDEK cities and postal codes in Joomla

# LocationEntity: CDEK cities and postal codes in Joomla

WT CDEK library - Documentation

**Category:** [Libraries](https://web-tolk.ru/en/dev/biblioteki)

[Project](https://web-tolk.ru/en/dev/biblioteki/wt-cdek-library-for-joomla-developers)[Versions](https://web-tolk.ru/en/dev/biblioteki/wt-cdek-library-for-joomla-developers/versions)[Documentation](https://web-tolk.ru/en/dev/biblioteki/wt-cdek-library-for-joomla-developers/documentation)[GitHub](https://github.com/WebTolk/WT-CDEK-Joomla-PHP-library)

LocationEntity in WT CDEK for Joomla covers cities, regions, postal codes and coordinates. This reference explains its purpose, parameters and PHP examples for Joomla extensions.

LocationEntity provides CDEK geography: regions, cities, postal codes, coordinates and city suggestions.

Access the entity through the Cdek facade:

```
$location = $cdek->location();
```

## `getRegions()`

### Signature

```
public function getRegions(array $request_options = []): array
```

### REST API

- `GET /v2/location/regions`

### Purpose

Lists regions. Defaults: size=1000, page=0, lang=rus. An array of country codes is joined with commas.

### Parameters

`country_codes`: array or comma-separated string; optional `size`, `page`, `lang`.

### Returns

Region records.

### Example

```
<?php

declare(strict_types=1);

use Webtolk\Cdekapi\Cdek;

defined('_JEXEC') or die;

$cdek = new Cdek();

$regions = $cdek->location()->getRegions([
    'country_codes' => ['RU'],
]);
```

## `getCities()`

### Signature

```
public function getCities(array $request_options = []): array
```

### REST API

- `GET /v2/location/cities`

### Purpose

Lists cities. Defaults: size=500, page=0, lang=rus.

### Parameters

Filters include `country_codes`, `postal_code`, `region_code`, `city`, `fias_guid`, `size`, `page`, `lang`.

### Returns

City records with CDEK codes and reference information.

### Example

```
<?php

declare(strict_types=1);

use Webtolk\Cdekapi\Cdek;

defined('_JEXEC') or die;

$cdek = new Cdek();

$cities = $cdek->location()->getCities([
    'postal_code' => '630099',
    'city'        => 'Новосибирск',
    'size'        => 1,
]);
```

## `getPostalCodes()`

### Signature

```
public function getPostalCodes(int $city_code): array
```

### REST API

- `GET /v2/location/postalcodes`

### Purpose

Lists postal codes for a CDEK city code.

### Parameters

`$city_code`: CDEK city code.

### Returns

Postal codes, or an error if the code is not supplied.

### Example

```
<?php

declare(strict_types=1);

use Webtolk\Cdekapi\Cdek;

defined('_JEXEC') or die;

$cdek = new Cdek();

$indexes = $cdek->location()->getPostalCodes(270);
```

## `getCityByCoordinates()`

### Signature

```
public function getCityByCoordinates(array $request_options = []): array
```

### REST API

- `GET /v2/location/coordinates`

### Purpose

Resolves a location using coordinates and normalizes short key names.

### Parameters

Use `latitude`/`longitude`, or `lat`/`lng`, or `lat`/`lon`.

### Returns

Resolved location data.

### Example

```
<?php

declare(strict_types=1);

use Webtolk\Cdekapi\Cdek;

defined('_JEXEC') or die;

$cdek = new Cdek();

$result = $cdek->location()->getCityByCoordinates([
    'lat' => 55.030199,
    'lng' => 82.920430,
]);
```

## `suggestCities()`

### Signature

```
public function suggestCities(string $city_name, string $country_code = ''): array
```

### REST API

- `GET /v2/location/suggest/cities`

### Purpose

Returns city name suggestions for autocomplete.

### Parameters

Required `$city_name`; optional ISO `$country_code`.

### Returns

Suggestions, typically including city_uuid, code, full_name and country_code.

### Example

```
<?php

declare(strict_types=1);

use Webtolk\Cdekapi\Cdek;

defined('_JEXEC') or die;

$cdek = new Cdek();

$result = $cdek->location()->suggestCities('Саратов', 'RU');
```

[Overview and getting started](https://web-tolk.ru/en/dev/biblioteki/wt-cdek-library-for-joomla-developers/documentation/en/dev/biblioteki/wt-cdek-library-for-joomla-developers/documentation/wt-cdek-library-joomla-form-fields)

[WT CDEK 1.4.0 source code on GitHub](https://github.com/WebTolk/WT-CDEK-Joomla-PHP-library/blob/v.1.4.0/lib_webtolk_wtcdek/src/Entities/LocationEntity.php)

## JSON-LD Schema

```json
{
    "@context": "https://schema.org",
    "@type": "BreadcrumbList",
    "@id": "https://web-tolk.ru/#/schema/BreadcrumbList/17",
    "itemListElement": [
        {
            "@type": "ListItem",
            "position": 1,
            "item": {
                "@id": "https://web-tolk.ru/en",
                "name": "Home"
            }
        },
        {
            "@type": "ListItem",
            "position": 2,
            "item": {
                "@id": "https://web-tolk.ru/en/dev",
                "name": "Joomla extensions"
            }
        },
        {
            "@type": "ListItem",
            "position": 3,
            "item": {
                "@id": "/en/dev/biblioteki",
                "name": "Libraries"
            }
        },
        {
            "@type": "ListItem",
            "position": 4,
            "item": {
                "@id": "/en/dev/biblioteki/wt-cdek-library-for-joomla-developers",
                "name": "WT CDEK library "
            }
        },
        {
            "@type": "ListItem",
            "position": 5,
            "item": {
                "@id": "/en/dev/biblioteki/wt-cdek-library-for-joomla-developers/documentation",
                "name": "Documentation"
            }
        },
        {
            "@type": "ListItem",
            "position": 6,
            "item": {
                "name": "LocationEntity: CDEK cities and postal codes in Joomla"
            }
        }
    ]
}
```

```json
{
    "@context": "https://schema.org",
    "@graph": [
        {
            "@type": "Organization",
            "@id": "https://web-tolk.ru/#/schema/Organization/base",
            "name": "WebTolk",
            "url": "https://web-tolk.ru/",
            "logo": {
                "@type": "ImageObject",
                "@id": "https://web-tolk.ru/#/schema/ImageObject/logo",
                "url": "https://web-tolk.ru/images/webtolk-1080p.jpg",
                "contentUrl": "https://web-tolk.ru/images/webtolk-1080p.jpg",
                "width": 1920,
                "height": 1080
            },
            "image": {
                "@id": "https://web-tolk.ru/#/schema/ImageObject/logo"
            },
            "sameAs": [
                "https://github.com/WebTolk",
                "https://github.com/sergeytolkachyov",
                "https://vk.com/web_tolk",
                "https://vk.com/webtolkru",
                "https://tenchat.ru/sergeytolkachyov",
                "https://t.me/sergeytolkachyov",
                "https://t.me/webtolkru"
            ]
        },
        {
            "@type": "WebSite",
            "@id": "https://web-tolk.ru/#/schema/WebSite/base",
            "url": "https://web-tolk.ru/",
            "name": "WebTolk websites development, Joomla Extensions",
            "publisher": {
                "@id": "https://web-tolk.ru/#/schema/Organization/base"
            }
        },
        {
            "@type": "WebPage",
            "@id": "https://web-tolk.ru/#/schema/WebPage/base",
            "url": "https://web-tolk.ru/en/dev/biblioteki/wt-cdek-library-for-joomla-developers/documentation/wt-cdek-entities-location",
            "name": "LocationEntity: CDEK cities and postal codes in Joomla | WT CDEK - WebTolk websites development, Joomla Extensions",
            "description": "LocationEntity for Joomla: cities, regions, postal codes and coordinates. WT CDEK documentation with CDEK API parameters and PHP integration examples.",
            "isPartOf": {
                "@id": "https://web-tolk.ru/#/schema/WebSite/base"
            },
            "about": {
                "@id": "https://web-tolk.ru/#/schema/TechArticle/base"
            },
            "inLanguage": "en-GB",
            "breadcrumb": {
                "@id": "https://web-tolk.ru/#/schema/BreadcrumbList/17"
            }
        },
        {
            "@type": "TechArticle",
            "headline": "LocationEntity: CDEK cities and postal codes in Joomla",
            "url": "https://web-tolk.ru/en/dev/biblioteki/wt-cdek-library-for-joomla-developers/documentation/wt-cdek-entities-location",
            "description": "LocationEntity in WT CDEK for Joomla covers cities, regions, postal codes and coordinates. This reference explains its purpose, parameters and PHP examples for Joomla extensions.",
            "mainEntityOfPage": {
                "@type": "WebPage",
                "url": "https://web-tolk.ru/en/dev/biblioteki/wt-cdek-library-for-joomla-developers/documentation/wt-cdek-entities-location"
            },
            "keywords": [
                "Joomla",
                " PHP",
                " CDEK API",
                " WT CDEK",
                " LocationEntity",
                " cities",
                " regions",
                " postal codes and coordinates"
            ]
        }
    ]
}
```