תרגום טקסט באמצעות Translate API

השירות Cloud Translation מאפשר לכם לתרגם מחרוזת שרירותית לכל שפה נתמכת. זיהוי שפה זמין גם במקרים שבהם שפת המקור לא ידועה.

מה תלמדו

  • יצירת בקשה ל-Cloud Translation API ושליחת קריאה ל-API באמצעות curl
  • תרגום טקסט
  • שימוש במהדורת Premium
  • זיהוי השפה

מה צריך לעשות

  • פרויקט ב-Google Cloud Platform
  • דפדפן, כמו Chrome או Firefox

סקר

איך תשתמשו במדריך הזה?

רק קוראים את המאמר קוראים את המאמר ומבצעים את התרגילים

איזה דירוג מגיע לדעתך לחוויית השימוש שלך ב-Google Cloud Platform?

מתחילים ביניים מומחים

הגדרת סביבה בקצב אישי

אם עדיין אין לכם חשבון Google (Gmail או Google Apps), אתם צריכים ליצור חשבון. נכנסים ל-Google Cloud Platform Console‏ (console.cloud.google.com) ויוצרים פרויקט חדש:

Screenshot from 2016-02-10 12:45:26.png

חשוב לזכור את מזהה הפרויקט, שהוא שם ייחודי בכל הפרויקטים ב-Google Cloud (השם שמופיע למעלה כבר תפוס ולא יתאים לכם, מצטערים!).

משתמשים חדשים ב-Google Cloud Platform זכאים לתקופת ניסיון בחינם בשווי 300$.

הגדרה של Codelab בכנס

המדריך ישתף איתכם חשבונות זמניים עם פרויקטים קיימים שכבר הוגדרו, כך שלא תצטרכו לדאוג להפעלת החיוב או לכל עלות שקשורה להפעלת ה-codelab הזה. שימו לב שכל החשבונות האלה יושבתו זמן קצר אחרי סיום ה-codelab.

אחרי שמקבלים מהמדריך שם משתמש וסיסמה זמניים לכניסה, מתחברים למסוף Google Cloud: https://console.cloud.google.com/.

אלה הפרטים שיוצגו אחרי הכניסה לחשבון :

לוחצים על סמל התפריט בפינה השמאלית העליונה.

בתפריט הנפתח, בוחרים באפשרות API Manager.

לוחצים על Enable API (הפעלת ה-API).

לאחר מכן, מחפשים את האפשרות 'תרגום' בתיבת החיפוש. לוחצים על Google Cloud Translation API:

אם ממשק ה-API כבר מופעל, יופיע לחצן 'השבתה'. אל תשביתו את ה-API.

אם ה-API מושבת, לוחצים על Enable כדי להפעיל את Cloud Translation API:

מחכים כמה שניות עד שהאפשרות תופעל. אחרי ההפעלה, תראו את ההודעה הבאה:

‫Google Cloud Shell היא סביבת שורת פקודה שפועלת בענן. המכונה הווירטואלית הזו מבוססת על Debian, וטעונים בה כל הכלים הדרושים למפתחים (gcloud,‏ bq,‏ git וכלים אחרים), ועם ספריית בית בעלת אחסון מתמיד בגודל 5GB. נשתמש ב-Cloud Shell כדי ליצור את הבקשה שלנו ל-Translation API.

כדי להתחיל להשתמש ב-Cloud Shell, לוחצים על הסמל 'הפעלת Google Cloud Shell' Screen Shot 2015-06-08 at 5.30.32 PM.png בפינה השמאלית העליונה של סרגל הכותרת.

בחלק התחתון של המסוף ייפתח סשן של Cloud Shell בתוך מסגרת חדשה ותופיע הודעה של שורת הפקודה. ממתינים עד להופעת ההנחיה user@project:~$

מכיוון שנשתמש ב-curl כדי לשלוח בקשה ל-Translation API, נצטרך ליצור מפתח API כדי להעביר אותו בכתובת ה-URL של הבקשה. כדי ליצור מפתח API, עוברים לקטע API Manager (ניהול API) בלוח הבקרה של הפרויקט:

לאחר מכן עוברים לכרטיסייה Credentials ולוחצים על Create credentials:

בתפריט הנפתח, בוחרים באפשרות API key:

לאחר מכן, מעתיקים את המפתח שנוצר.

מעתיקים את מפתח ה-API ללוח ואז שומרים אותו במשתנה סביבה ב-Cloud Shell באמצעות שורת הקוד הבאה. חשוב להחליף את המחרוזת YOUR_API_KEY במפתח מלוח העריכה.

export API_KEY=YOUR_API_KEY

בדוגמה הזו נתרגם את המחרוזת 'My name is Steve' לספרדית. מעבירים את הטקסט לתרגום, יחד עם משתנה הסביבה של מפתח ה-API ששמרתם קודם, אל Translation API באמצעות פקודת ה-curl הבאה:

TEXT="My%20name%20is%20Steve"
curl "https://translation.googleapis.com/language/translate/v2?target=es&key=${API_KEY}&q=${TEXT}"

התגובה אמורה להיראות כך:

{
  "data": {
    "translations": [
      {
        "translatedText": "Mi nombre es Steve",
        "detectedSourceLanguage": "en"
      }
    ]
  }
}

בתשובה, אפשר לראות את הטקסט המתורגם ואת שפת המקור שזוהתה על ידי ה-API.​

בנוסף לתרגום טקסט, אפשר גם לזהות את השפה של הטקסט באמצעות Translate API. בדוגמה הזו תזהו את השפה של שני מחרוזות. מעבירים את הטקסט לבדיקה, יחד עם משתנה הסביבה של מפתח ה-API ששמרתם קודם, אל Translation API באמצעות פקודת ה-curl הבאה: 

TEXT_ONE="Meu%20nome%20é%20Steven"
TEXT_TWO="日本のグーグルのオフィスは、東京の六本木ヒルズにあります"
curl "https://translation.googleapis.com/language/translate/v2/detect?key=${API_KEY}&q=${TEXT_ONE}&q=${TEXT_TWO}"

התשובה אמורה להיראות כך:

{
  "data": {
    "detections": [
      [
        {
          "confidence": 0.20671661198139191,
          "isReliable": false,
          "language": "pt"
        }
      ],
      [
        {
          "confidence": 0.97750955820083618,
          "isReliable": false,
          "language": "ja"
        }
      ]
    ]
  }
}

השפות שמוחזרות בדוגמה הזו הן pt ו-ja. אלה מזהי ISO-639-1 לפורטוגזית וליפנית. ברשימת השפות שנתמכות על ידי Translation API מפורטים כל קודי השפות האפשריים שיכולים לחזור.

למדתם איך לתרגם טקסט באמצעות Cloud Translation API.

מה למדנו

  • יצירת בקשה ל-Cloud Translation API ושליחת קריאה ל-API באמצעות curl
  • תרגום טקסט
  • שימוש במהדורת Premium
  • זיהוי השפה

השלבים הבאים