locationservice.php

См. документацию.

<?php
 
namespace Bitrix\Location\Service;
 
use Bitrix\Location\Exception\RuntimeException;
use Bitrix\Location\Common\BaseService;
use Bitrix\Main\Result;
use Bitrix\Location\Entity;
use Bitrix\Location\Repository\LocationRepository;
use Bitrix\Location\Infrastructure\Service\Config;
use Bitrix\Location\Common\RepositoryTrait;

final class LocationService extends BaseService
{
    use RepositoryTrait;

    protected static $instance;

    protected $repository = null;

    public function findById(int $locationId, string $languageId, int $searchScope = LOCATION_SEARCH_SCOPE_ALL)
    {
        $result = false;
 
        try
        {
            $result = $this->repository->findById($locationId, $languageId, $searchScope);
        }
        catch (RuntimeException $exception)
        {
            $this->processException($exception);
        }
 
        return $result;
    }

    public function findByExternalId(string $externalId, string $sourceCode, string $languageId, int $searchScope = LOCATION_SEARCH_SCOPE_ALL)
    {
        $result = false;
 
        try
        {
            $result = $this->repository->findByExternalId($externalId, $sourceCode, $languageId, $searchScope);
        }
        catch (RuntimeException $exception)
        {
            $this->processException($exception);
        }
 
        return $result;
    }

    public function findByCoords(
        float $lat,
        float $lng,
        int $zoom,
        string $languageId
    ): ?Entity\Location
    {
        try
        {
            return $this->repository->findByCoords(
                $lat,
                $lng,
                $zoom,
                $languageId,
                LOCATION_SEARCH_SCOPE_EXTERNAL
            );
        }
        catch (RuntimeException $exception)
        {
            $this->processException($exception);
        }
 
        return null;
    }

    public function autocomplete(array $params, int $searchScope = LOCATION_SEARCH_SCOPE_ALL)
    {
        $result = [];
 
        try
        {
            $result = $this->repository->autocomplete($params, $searchScope);
        }
        catch (RuntimeException $exception)
        {
            $this->processException($exception);
        }
 
        return $result;
    }

    public function findParents(Entity\Location $location, string $languageId, int $searchScope = LOCATION_SEARCH_SCOPE_ALL)
    {
        $result = false;
 
        try
        {
            $result = $this->repository->findParents($location, $languageId, $searchScope);
        }
        catch (RuntimeException $exception)
        {
            $this->processException($exception);
        }
 
        return $result;
    }

    public function save(Entity\Location $location): Result
    {
        return $this->repository->save($location);
    }

    public function delete(Entity\Location $location): Result
    {
        return $this->repository->delete($location);
    }

    protected function __construct(Config\Container $config)
    {
        $this->setRepository($config->get('repository'));
 
        parent::__construct($config);
    }

    public function saveParents(Entity\Location\Parents $parents): Result
    {
        return $this->repository->saveParents($parents);
    }
}