urlmaker.php

<?php
 
namespace Bitrix\Location\Source\Google\Requesters;
 
use Bitrix\Main\ArgumentNullException;
use Bitrix\Main\Text\Encoding;
 
class UrlMaker
{
    public function make(array $params, string $url, array $required = [], array $encode = []): string
    {
        $this->checkRequiredFields($params, $required);
        $params = $this->encodeFields($params, $encode);
        return $this->buildQuery($params, $url);
    }
 
    protected function buildQuery(array $params, string $url): string
    {
        $query = '';
 
        foreach($params as $key => $value)
        {
            if($query <> '')
            {
                $query .= '&';
            }
 
            $query .= $key.'='.$value;
        }
 
        return $url.'?'.$query;
    }
 
    protected function checkRequiredFields(array $params, array $requiredFields): void
    {
        foreach($requiredFields as $field)
        {
            if(!isset($params[$field]))
            {
                throw new ArgumentNullException('data['.$field.']');
            }
        }
    }
 
    protected function encodeFields(array $params, array $fieldsToEncode): array
    {
        foreach($fieldsToEncode as $field)
        {
            if(!isset($params[$field]))
            {
                throw new ArgumentNullException('Field "'.$field.'" is absent');
            }
 
            if(ToUpper(SITE_CHARSET) !== 'UTF-8')
            {
                $params[$field] = urlencode(
                    Encoding::convertEncoding(
                        $params[$field],
                        SITE_CHARSET,
                        'UTF-8'
                    ));
            }
        }
 
        return $params;
    }
}