---
title: "LocationEntity: города и индексы СДЭК в Joomla | WT CDEK - WebTolk"
description: "LocationEntity для Joomla: города, регионы, индексы и координаты. Документация WT CDEK, параметры API СДЭК и PHP-примеры для разработчиков."
url: "https://web-tolk.ru/dev/biblioteki/wt-cdek-library-for-joomla-developers/documentation/wt-cdek-entities-location"
date: "2026-11-02T13:05:16+00:00"
language: "ru-RU"
---

## Breadcrumbs

[Главная](https://web-tolk.ru/) > [Расширения Joomla](https://web-tolk.ru/dev) > [Библиотеки](/dev/biblioteki) > [WT CDEK library](/dev/biblioteki/wt-cdek-library-for-joomla-developers) > [Документация](/dev/biblioteki/wt-cdek-library-for-joomla-developers/documentation) > LocationEntity: города и индексы СДЭК в Joomla

# LocationEntity: города и индексы СДЭК в Joomla

WT CDEK library - Документация

**Категория:** [Библиотеки](https://web-tolk.ru/dev/biblioteki)

[Проект](https://web-tolk.ru/dev/biblioteki/wt-cdek-library-for-joomla-developers)[Версии](https://web-tolk.ru/dev/biblioteki/wt-cdek-library-for-joomla-developers/versions)[Документация](https://web-tolk.ru/dev/biblioteki/wt-cdek-library-for-joomla-developers/documentation)[GitHub](https://github.com/WebTolk/WT-CDEK-Joomla-PHP-library)

LocationEntity в библиотеке WT CDEK для Joomla: города, регионы, индексы и координаты. На странице — назначение, параметры и примеры PHP для расширений Joomla.

`Webtolk\Cdekapi\Entities\LocationEntity` — это справочная Entity для работы с географией СДЭК. Именно через нее обычно решают задачи автодополнения города, поиска кодов городов, индексов и привязки координат к населенному пункту.

Получение Entity:

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

## `getRegions(array $request_options = []): array`

**Сигнатура**

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

**REST API**

`GET /v2/location/regions`

**Что делает**

Возвращает список регионов. По умолчанию библиотека подставляет:

- `size = 1000`;
- `page = 0`;
- `lang = rus`.

Если `country_codes` передать массивом, библиотека сама склеит его в строку через запятую.

**Параметры**

- `country_codes` — массив кодов стран или уже готовая строка;
- `size`;
- `page`;
- `lang`.

**Что возвращает**

Массив регионов.

**Пример**

```
<?php

declare(strict_types=1);

use Webtolk\Cdekapi\Cdek;

defined('_JEXEC') or die;

$cdek = new Cdek();

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

## `getCities(array $request_options = []): array`

**Сигнатура**

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

**REST API**

`GET /v2/location/cities`

**Что делает**

Возвращает список населенных пунктов.

По умолчанию библиотека подставляет:

- `size = 500`;
- `page = 0`;
- `lang = rus`.

**Параметры**

- `country_codes`;
- `postal_code`;
- `region_code`;
- `city`;
- `fias_guid`;
- `size`;
- `page`;
- `lang`.

**Что возвращает**

Массив городов с кодами СДЭК и дополнительной справочной информацией.

**Пример**

```
<?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(int $city_code): array`

**Сигнатура**

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

**REST API**

`GET /v2/location/postalcodes`

**Что делает**

Возвращает список почтовых индексов по коду города СДЭК.

**Параметры**

- `$city_code` — код города СДЭК.

**Что возвращает**

Массив индексов или ошибку, если код города не передан.

**Пример**

```
<?php

declare(strict_types=1);

use Webtolk\Cdekapi\Cdek;

defined('_JEXEC') or die;

$cdek = new Cdek();

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

## `getCityByCoordinates(array $request_options = []): array`

**Сигнатура**

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

**REST API**

`GET /v2/location/coordinates`

**Что делает**

Определяет локацию по координатам.

**Параметры**

Можно передать:

- `latitude` и `longitude`;
- либо сокращенные варианты `lat` и `lng`;
- либо `lat` и `lon`.

Библиотека сама нормализует короткие названия ключей.

**Что возвращает**

Массив с определенной локацией.

**Пример**

```
<?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(string $city_name, string $country_code = ''): array`

**Сигнатура**

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

**REST API**

`GET /v2/location/suggest/cities`

**Что делает**

Возвращает подсказки по названию города. Это один из самых удобных методов для AJAX-поиска города в форме оформления заказа.

**Параметры**

- `$city_name` — обязательная строка поиска;
- `$country_code` — необязательный ISO-код страны.

**Что возвращает**

Массив подсказок. Обычно каждый элемент содержит `city_uuid`, `code`, `full_name`, `country_code`.

**Пример**

```
<?php

declare(strict_types=1);

use Webtolk\Cdekapi\Cdek;

defined('_JEXEC') or die;

$cdek = new Cdek();

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

[Обзор и начало работы](https://web-tolk.ru/dev/biblioteki/wt-cdek-library-for-joomla-developers/documentation/dev/biblioteki/wt-cdek-library-for-joomla-developers/documentation/wt-cdek-library-joomla-form-fields)

[Исходный код WT CDEK 1.4.0 на 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/",
                "name": "Главная"
            }
        },
        {
            "@type": "ListItem",
            "position": 2,
            "item": {
                "@id": "https://web-tolk.ru/dev",
                "name": "Расширения Joomla"
            }
        },
        {
            "@type": "ListItem",
            "position": 3,
            "item": {
                "@id": "/dev/biblioteki",
                "name": "Библиотеки"
            }
        },
        {
            "@type": "ListItem",
            "position": 4,
            "item": {
                "@id": "/dev/biblioteki/wt-cdek-library-for-joomla-developers",
                "name": "WT CDEK library"
            }
        },
        {
            "@type": "ListItem",
            "position": 5,
            "item": {
                "@id": "/dev/biblioteki/wt-cdek-library-for-joomla-developers/documentation",
                "name": "Документация"
            }
        },
        {
            "@type": "ListItem",
            "position": 6,
            "item": {
                "name": "LocationEntity: города и индексы СДЭК в 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",
            "publisher": {
                "@id": "https://web-tolk.ru/#/schema/Organization/base"
            }
        },
        {
            "@type": "WebPage",
            "@id": "https://web-tolk.ru/#/schema/WebPage/base",
            "url": "https://web-tolk.ru/dev/biblioteki/wt-cdek-library-for-joomla-developers/documentation/wt-cdek-entities-location",
            "name": "LocationEntity: города и индексы СДЭК в Joomla | WT CDEK - WebTolk",
            "description": "LocationEntity для Joomla: города, регионы, индексы и координаты. Документация WT CDEK, параметры API СДЭК и PHP-примеры для разработчиков.",
            "isPartOf": {
                "@id": "https://web-tolk.ru/#/schema/WebSite/base"
            },
            "about": {
                "@id": "https://web-tolk.ru/#/schema/TechArticle/base"
            },
            "inLanguage": "ru-RU",
            "breadcrumb": {
                "@id": "https://web-tolk.ru/#/schema/BreadcrumbList/17"
            }
        },
        {
            "@type": "TechArticle",
            "headline": "LocationEntity: города и индексы СДЭК в Joomla",
            "url": "https://web-tolk.ru/dev/biblioteki/wt-cdek-library-for-joomla-developers/documentation/wt-cdek-entities-location",
            "description": "LocationEntity в библиотеке WT CDEK для Joomla: города, регионы, индексы и координаты. На странице — назначение, параметры и примеры PHP для расширений Joomla.",
            "mainEntityOfPage": {
                "@type": "WebPage",
                "url": "https://web-tolk.ru/dev/biblioteki/wt-cdek-library-for-joomla-developers/documentation/wt-cdek-entities-location"
            },
            "keywords": [
                "Joomla",
                " PHP",
                " СДЭК API",
                " WT CDEK",
                " LocationEntity",
                " города",
                " регионы",
                " индексы и координаты"
            ]
        }
    ]
}
```