3
0
Fork 0
mirror of https://github.com/farmOS/farmOS.git synced 2024-02-23 11:37:38 +01:00
farmOS/modules/core/location/src/AssetLocationInterface.php

111 lines
2.7 KiB
PHP

<?php
namespace Drupal\farm_location;
use Drupal\asset\Entity\AssetInterface;
use Drupal\log\Entity\LogInterface;
/**
* Asset location logic.
*/
interface AssetLocationInterface {
/**
* Check if an asset is a location.
*
* @param \Drupal\asset\Entity\AssetInterface $asset
* The Asset entity.
*
* @return bool
* Returns TRUE if it is a location, FALSE otherwise.
*/
public function isLocation(AssetInterface $asset): bool;
/**
* Check if an asset is fixed.
*
* @param \Drupal\asset\Entity\AssetInterface $asset
* The Asset entity.
*
* @return bool
* Returns TRUE if it is fixed, FALSE otherwise.
*/
public function isFixed(AssetInterface $asset): bool;
/**
* Check if an asset is located within other location assets.
*
* @param \Drupal\asset\Entity\AssetInterface $asset
* The Asset entity.
*
* @return bool
* Returns TRUE if the asset has a location, FALSE otherwise.
*/
public function hasLocation(AssetInterface $asset): bool;
/**
* Check if an asset has geometry.
*
* @param \Drupal\asset\Entity\AssetInterface $asset
* The Asset entity.
*
* @return bool
* Returns TRUE if the asset has geometry, FALSE otherwise.
*/
public function hasGeometry(AssetInterface $asset): bool;
/**
* Get location assets that an asset is located within.
*
* @param \Drupal\asset\Entity\AssetInterface $asset
* The Asset entity.
*
* @return array
* Returns an array of assets.
*/
public function getLocation(AssetInterface $asset): array;
/**
* Get an asset's geometry.
*
* @param \Drupal\asset\Entity\AssetInterface $asset
* The Asset entity.
*
* @return string
* Returns a WKT string.
*/
public function getGeometry(AssetInterface $asset): string;
/**
* Find the latest movement log that references an asset.
*
* @param \Drupal\asset\Entity\AssetInterface $asset
* The Asset entity.
*
* @return \Drupal\log\Entity\LogInterface|null
* A log entity, or NULL if no logs were found.
*/
public function getMovementLog(AssetInterface $asset): ?LogInterface;
/**
* Set an asset's intrinsic geometry.
*
* @param \Drupal\asset\Entity\AssetInterface $asset
* The Asset entity.
* @param string $wkt
* Geometry as a WKT string.
*/
public function setIntrinsicGeometry(AssetInterface $asset, string $wkt): void;
/**
* Get assets that are in a location.
*
* @param \Drupal\asset\Entity\AssetInterface $location
* The location asset entity.
*
* @return array
* Returns an array of assets.
*/
public function getAssetsByLocation(AssetInterface $location): array;
}