/** * 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))); }