/**
* Finds named entities (currently finds proper names) in the text, entity
* types, salience, mentions for each entity, and other properties in the
* document.
*
* Example:
* ```
* $annotation = $language->analyzeEntities('Google Cloud Platform is a powerful tool.');
*
* foreach ($annotation->entities() as $entity) {
* echo $entity['type'];
* }
* ```
*
* @codingStandardsIgnoreStart
* @see https://cloud.google.com/natural-language/reference/rest/v1beta1/documents/analyzeEntities Analyze Entities API documentation
* @codingStandardsIgnoreEnd
*
* @param string|StorageObject $content The content to analyze.
* @param array $options [optional] {
* Configuration options.
*
* @type string $type The document type. Acceptable values are
* `PLAIN_TEXT` or `HTML`. **Defaults to** `"PLAIN_TEXT"`.
* @type string $language The language of the document. Both ISO
* (e.g., en, es) and BCP-47 (e.g., en-US, es-ES) language codes
* are accepted. Defaults to `"en"` (English).
* @type string $encodingType The text encoding type used by the API to
* calculate offsets. Acceptable values are `"NONE"`, `"UTF8"`,
* `"UTF16"` and `"UTF32"`. **Defaults to** `"UTF8"`.
* }
* @return Annotation
*/
public function analyzeEntities($content, array $options = [])
{
return new Annotation($this->connection->analyzeEntities($this->formatRequest($content, $options)));
}