HelsinkiNearYouResultsController.php

<?php

declare(strict_types=1);

namespace Drupal\helfi_etusivu\Controller;

use Drupal\Component\Utility\Xss;
use Drupal\Core\Controller\ControllerBase;
use Drupal\Core\Url;
use Drupal\helfi_etusivu\Servicemap;
use Drupal\helfi_react_search\LinkedEvents;
use Symfony\Component\HttpFoundation\JsonResponse;
use Symfony\Component\HttpFoundation\RedirectResponse;
use Symfony\Component\HttpFoundation\Request;

/**
 * Helsinki near you controller.
 */
class HelsinkiNearYouResultsController extends ControllerBase {

  /**
   * Constructs a new instance.
   *
   * @param \Drupal\helfi_etusivu\Servicemap $servicemap
   *   The servicemap service.
   * @param \Drupal\helfi_react_search\LinkedEvents $linkedEvents
   *   The linked events service.
   */
  public function __construct(
    protected readonly Servicemap $servicemap,
    protected readonly LinkedEvents $linkedEvents,
  ) {
  }

  /**
   * Returns a renderable array.
   *
   * @param \Symfony\Component\HttpFoundation\Request $request
   *   The request.
   *
   * @return array
   *   A renderable array.
   */
  public function content(Request $request) : array|RedirectResponse {
    $address = $request->query->get('q');
    $return_url = Url::fromRoute('helfi_etusivu.helsinki_near_you');

    if (!$address) {
      $this->messenger()->addError($this->t('Please enter an address', [], ['context' => 'Helsinki near you']));
      return $this->redirect('helfi_etusivu.helsinki_near_you');
    }

    $addressData = $this->getCoordinates(
      Xss::filter(
        urldecode($address)
      )
    );

    if (!$addressData) {
      $this->messenger()->addError(
        $this->t(
          'The address you input yielded no results. You may want to try a different address.',
          [],
          ['context' => 'Helsinki near you']
        )
      );
      return $this->redirect('helfi_etusivu.helsinki_near_you');
    }

    return [
      '#attached' => [
        'drupalSettings' => [
          'helsinki_near_you' => [
            'events_api_url' => $this->linkedEvents->getEventsRequest([
              'dwithin_origin' => $addressData['coordinates'],
              'dwithin_distance' => 1000,
            ]),
          ],
        ],
      ],
      '#back_link_label' => $this->t('Edit address', [], ['context' => 'Helsinki near you']),
      '#back_link_url' => $return_url,
      '#cache' => [
        'contexts' => ['url.query_args:q'],
      ],
      '#coordinates' => $addressData ? $addressData['coordinates'] : NULL,
      '#theme' => 'helsinki_near_you_results_page',
      '#title' => $this->t(
        'Services, events and news near your address @address',
        ['@address' => $addressData ? $this->resolveTranslation($addressData['address_translations']) : ''],
        ['context' => 'Helsinki near you']
      ),
    ];
  }

  /**
   * Serves autocomplete suggestions for the search form.
   *
   * @param \Symfony\Component\HttpFoundation\Request $request
   *   The request.
   *
   * @return \Symfony\Component\HttpFoundation\JsonResponse
   *   The result as JSON.
   */
  public function addressSuggestions(Request $request) : JsonResponse {
    $q = $request->query->get('q');
    $suggestions = [];

    $results = $this->servicemap->query($q, 10);

    foreach ($results as $result) {
      $name = $this->resolveTranslation($result->name);

      $suggestions[] = [
        'label' => $name,
        'value' => $name,
      ];
    }

    return new JsonResponse($suggestions);
  }

  /**
   * Get coordinates from servicemap API.
   *
   * @param string $address
   *   The address.
   *
   * @return array
   *   The coordinates.
   */
  protected function getCoordinates(string $address) : ?array {
    $results = $this->servicemap->query($address);

    if (
      isset($results['0']->name) &&
      isset($results['0']->location->coordinates)
    ) {
      return [
        'address_translations' => $results['0']->name,
        'coordinates' => $results['0']->location->coordinates,
      ];
    }

    return NULL;
  }

  /**
   * Resolves the translation string for given translation object.
   *
   * Returns the translation for the current language if it exists, otherwise
   * returns the Finnish translation.
   *
   * @param \stdClass $translations
   *   The translations object.
   *
   * @return string
   *   The translated string.
   */
  protected function resolveTranslation(\stdClass $translations) : string {
    $langcode = $this->languageManager()->getCurrentLanguage()->getId();
    return $translations->{"$langcode"} ?? $translations->fi;
  }

}