baseconverter.php

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

<?php
 
namespace Bitrix\Location\Source\Google\Converters;
 
use Bitrix\Location\Entity\Address;
use Bitrix\Location\Entity\Address\FieldType;
use Bitrix\Location\Entity\Format\TemplateType;
use Bitrix\Location\Entity\Location;
use Bitrix\Location\Service\FormatService;
use Bitrix\Location\Entity\Address\Converter\StringConverter;

abstract class BaseConverter
{
    protected $languageId = '';

    public function __construct(string $languageId)
    {
        $this->languageId = $languageId;
    }

    abstract public function convert(array $data);
 
    public function isPostCode(array $types)
    {
        return in_array('postal_code', $types);
    }

    public function convertTypes(array $types, string $typesClass): int
    {
        $result = $typesClass::UNKNOWN;
 
        foreach($types as $type)
        {
            $result = PlaceTypeConverter::convert($type);
 
            if(!$typesClass::isValueExist($result))
            {
                $result = $typesClass::UNKNOWN;
                continue;
            }
 
            if($result !== $typesClass::UNKNOWN)
            {
                break;
            }
        }
 
        return $result;
    }
 
    protected function createAddress(array $addressComponents): Address
    {
        $address = new Address($this->languageId);
 
        foreach ($addressComponents as $item)
        {
            if ($type = $this->convertTypes($item['types'], FieldType::class))
            {
                $address->setFieldValue((int)$type, (string)$item['long_name']);
            }
        }
 
        $format = FormatService::getInstance()->findDefault($this->languageId);
 
        $addressLine1 = StringConverter::convertToStringTemplate(
            $address,
            $format->getTemplate(TemplateType::ADDRESS_LINE_1),
            StringConverter::STRATEGY_TYPE_TEMPLATE,
            StringConverter::CONTENT_TYPE_TEXT
        );
 
        if($addressLine1)
        {
            $address->setFieldValue(FieldType::ADDRESS_LINE_1, $addressLine1);
        }
 
        return $address;
    }
}