Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/datpmt/google-translate-free
Google Translate Free
https://github.com/datpmt/google-translate-free
google-translate google-translate-free-api translate
Last synced: 17 days ago
JSON representation
Google Translate Free
- Host: GitHub
- URL: https://github.com/datpmt/google-translate-free
- Owner: datpmt
- License: mit
- Created: 2024-05-10T02:07:27.000Z (9 months ago)
- Default Branch: main
- Last Pushed: 2024-05-13T02:21:11.000Z (9 months ago)
- Last Synced: 2024-05-14T02:35:23.861Z (9 months ago)
- Topics: google-translate, google-translate-free-api, translate
- Language: Ruby
- Homepage: https://api.datpmt.com
- Size: 15.6 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# Google Translate Free
This repository is a robust translation service designed to help you with a variety of language-based features including direct translations, alternate translations, definitions, examples, transliterations, spelling suggestions, language detection, and highly relevant keyword suggestions.
Let's read the [documents](https://api.datpmt.com) before using it.
## Installation
Add this line to your application's Gemfile:
```ruby
gem 'google-translate-free', '~> 1.0.1'
```
And then execute:
$ bundle install
Or install it yourself as:
$ gem install google-translate-free
## Usage
To translate
```ruby
Translate.translate('summer', :vi, :en)
# => "mùa hè"
```
Without third params, Google Translate will auto-detect your source language.
```ruby
Translate.translate('summer', :vi)
# => "mùa hè"
```
For alternate Translations
```ruby
Translate.alternate_translations('summer', :vi, :en)
# =>
#[
# "mùa hè",
# "mùa hạ",
# "hè"
#]
```
Without third params, Google Translate will auto-detect your source language.
```ruby
Translate.alternate_translations('summer', :vi)
# =>
#[
# "mùa hè",
# "mùa hạ",
# "hè"
#]
```
For definitions
```ruby
Translate.definitions('summer')
# =>
#[
# {
# :noun=>[
# ["The warmest season of the year, in the northern hemisphere from june to august and in the southern hemisphere from december to february.", "summer vacation.", nil],
# ["A horizontal bearing beam, especially one supporting joists or rafters.", nil, nil]
# ]
# },
# {
# :verb=>[
# ["Spend the summer in a particular place.", nil, nil]
# ]
# }
#]
```
For examples
```ruby
Translate.examples('summer')
# =>
#[
# "The plant flowers in late summer.",
# "The golden summer of her life.",
# "A long hot summer.",
# "summer vacation."
#]
```
For transliteration
```ruby
Translate.transliteration('summer')
# => "ˈsəmər"
```
For spelling suggestions
```ruby
Translate.suggest('summmer')
# => "summer"
```
For language detection
```ruby
Translate.detection('summer')
# => ["en", 0.93254006]
```
For keyword suggestions
```ruby
Translate.see_more('summers')
# => "summer"
```
## Contributors
- [datpmt](https://github.com/datpmt)
I welcome contributions to this project.
1. Fork it.
2. Create your feature branch (`git checkout -b your-feature`).
3. Commit your changes (`git commit -am 'Add some feature'`).
4. Push to the branch (`git push origin your-feature`).
5. Create a new pull request.
## License
The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).