Translation
===========



Uses Microsoft's Azure Cognitive Services API to translate text.
For more information, check out https://azure.microsoft.com/en-us/pricing/details/cognitive-services/translator-text-api/.

Terms of use: https://www.microsoft.com/en-us/servicesagreement



.. toctree::
    :maxdepth: 2
    :titlesonly:
    :caption: RPC Categories





RPCS
----

.. function:: Translation.detectLanguage(text: String)

    Attempt to detect language of input text

    **Arguments:**

    - ``text: String`` (`String </docs/fundamentals/rpc-arg-types.html#String>`__) - Text in an unknown language

    **Returns:** ``String`` (`String </docs/fundamentals/rpc-arg-types.html#String>`__) - Abbreviation for name of language detected in text


.. function:: Translation.getSupportedLanguages()

    Attempt to detect language of input text

    **Returns:** ``List`` (`List </docs/fundamentals/rpc-arg-types.html#List>`__) - List of languages supported by the translator


.. function:: Translation.toEnglish(text: String)

    Translate text to English

    **Arguments:**

    - ``text: String`` (`String </docs/fundamentals/rpc-arg-types.html#String>`__) - Text in another language

    **Returns:** ``String`` (`String </docs/fundamentals/rpc-arg-types.html#String>`__) - Text translated to English


.. function:: Translation.translate(text: String, from: String?, to: String)

    Translate text between languages

    **Arguments:**

    - ``text: String`` (`String </docs/fundamentals/rpc-arg-types.html#String>`__) - Text in another language
    - ``from: String?`` (`String </docs/fundamentals/rpc-arg-types.html#String>`__) - Language to translate from (auto-detects if not specified)
    - ``to: String`` (`String </docs/fundamentals/rpc-arg-types.html#String>`__) - Language to translate to

    **Returns:** ``String`` (`String </docs/fundamentals/rpc-arg-types.html#String>`__) - Text translated to requested language