address.php

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

<?php
 
namespace Bitrix\Location\Entity;
 
use Bitrix\Location\Entity\Address\AddressLink;
use Bitrix\Location\Entity\Address\AddressLinkCollection;
use Bitrix\Location\Entity\Address\Converter\ArrayConverter;
use Bitrix\Location\Entity\Address\Converter\StringConverter;
use Bitrix\Location\Entity\Address\Field;
use Bitrix\Location\Entity\Address\FieldCollection;
use Bitrix\Location\Service\AddressService;
use Bitrix\Main\ArgumentNullException;
use Bitrix\Main\ORM\Data\DeleteResult;
use Bitrix\Main\SystemException;
use Bitrix\Main\Web\Json;

final class Address
{
    private $id = 0;
    private $languageId;
    protected $latitude = '';
    protected $longitude = '';
    private $location;
    private $fieldCollection;
    private $linkCollection = null;

    public function __construct(string $languageId)
    {
        $this->languageId = $languageId;
        $this->fieldCollection = new FieldCollection();
        $this->linkCollection = new AddressLinkCollection();
    }

    public function getId(): int
    {
        return $this->id;
    }

    public function setId(int $id): Address
    {
        $this->id = $id;
        return $this;
    }
    
    public function getLatitude(): string
    {
        return $this->latitude;
    }

    public function setLatitude(string $latitude): Address
    {
        $this->latitude = $latitude;
        return $this;
    }

    public function getLongitude(): string
    {
        return $this->longitude;
    }

    public function setLongitude(string $longitude): Address
    {
        $this->longitude = $longitude;
        return $this;
    }

    public function getLanguageId(): string
    {
        return $this->languageId;
    }

    public function getFieldCollection(): FieldCollection
    {
        return $this->fieldCollection;
    }

    public function setFieldCollection(FieldCollection $fieldCollection): Address
    {
        $this->fieldCollection = $fieldCollection;
 
        return $this;
    }

    public function getLocation():? Location
    {
        return $this->location;
    }

    public function setLocation(?Location $location): self
    {
        $this->location = $location;
        return $this;
    }

    public function setFieldValue(int $type, string $value): self
    {
        if($field = $this->getFieldCollection()->getItemByType($type))
        {
            $field->setValue($value);
        }
        else
        {
            $this->fieldCollection->addItem(
                (new Field($type))
                    ->setValue($value)
            );
        }
 
        return $this;
    }

    public function getAllFieldsValues(): array
    {
        $result = [];
 
        foreach ($this->getFieldCollection() as $field)
        {
            $result[$field->getType()] = $field->getValue();
        }
 
        return $result;
    }

    public function getFieldValue(int $type): ?string
    {
        $result = null;
 
        if($field = $this->getFieldCollection()->getItemByType($type))
        {
            $result = $field->getValue();
        }
 
        return $result;
    }

    public function isFieldExist(int $type): bool
    {
        return (bool)$this->getFieldCollection()->getItemByType($type);
    }

    public static function load(int $id)
    {
        return AddressService::getInstance()->findById($id);
    }

    public function save()
    {
        return AddressService::getInstance()->save($this);
    }

    public function delete(): DeleteResult
    {
        return AddressService::getInstance()->delete($this->getId());
    }

    public function toJson(): string
    {
        return Json::encode(ArrayConverter::convertToArray($this));
    }

    public function toArray(): array
    {
        return ArrayConverter::convertToArray($this);
    }

    public static function fromJson(string $jsonData): Address
    {
        return ArrayConverter::convertFromArray(Json::decode($jsonData));
    }

    public static function fromArray(array $arrayData): Address
    {
        return ArrayConverter::convertFromArray($arrayData);
    }

    public function setLinks(AddressLinkCollection $collection): void
    {
        $this->linkCollection = $collection;
    }

    public function getLinks(): AddressLinkCollection
    {
        return $this->linkCollection;
    }

    public function clearLinks(): void
    {
        $this->linkCollection->clear();
    }

    public function addLink(string $entityId, string $entityType): void
    {
        if($entityId === '')
        {
            throw new ArgumentNullException('entityId');
        }
 
        if($entityType === '')
        {
            throw new ArgumentNullException('entityType');
        }
 
        $this->linkCollection->addItem(
            new AddressLink($entityId, $entityType)
        );
    }

    public function hasLinks(): bool
    {
        return $this->linkCollection->count() > 0;
    }

    public function toString(
        Format $format,
        string $strategyType = StringConverter::STRATEGY_TYPE_TEMPLATE,
        string $contentType = StringConverter::CONTENT_TYPE_HTML
    ): string
    {
        return StringConverter::convertToString($this, $format, $strategyType, $contentType);
    }
}