Шпаргалка по Bitrix. Работа с местоположением

Шпаргалка по работе с данными местоположения на сайте Bitrix.

Получить названия городов в Bitrix

Для получения городов из модуля местоположения я использую следующий фильтр:

TYPE.ID — 5 (id типа местоположения можно получить в «Рабочий стол -> Магазин -> Настройки -> Местоположения -> Типы местоположений«)

$res = \Bitrix\Sale\Location\LocationTable::getList(array(
    'filter' => [
        '=TYPE.ID' => '5', 
        '=NAME.LANGUAGE_ID' => LANGUAGE_ID
    ],
    'select' =>[
        'NAME_RU' => 'NAME.NAME'
    ]
));

while ($item = $res->fetch()) {
    $listState[] = $item['NAME_RU']; 
}

Поиск городов по части слова названия города

Для поиска по части слова названия города я использую следующую конструкцию.

‘NAME_RU’ — ‘Ниж%’

$res = \Bitrix\Sale\Location\LocationTable::getList(array(
    'filter' => [
	'=TYPE.ID' => '5', 
	'=NAME.LANGUAGE_ID' => LANGUAGE_ID, 
	'NAME_RU' => 'Ниж%'
    ],
    'select' => [
	'NAME_RU' => 'NAME.NAME'
    ]
));

while($item = $res->fetch()) {
    $listState[] = $item['NAME_RU']; 
}