PolyLingo sasa inaunga mkono nambari za lugha za kikanda: fr-CA, pt-BR, es-MX na zaidi

Sasa unaweza kupitisha nambari za lahaja za kikanda moja kwa moja kama malengo ya tafsiri katika PolyLingo. fr-CA, pt-BR, es-MX, en-GB, na zingine kadhaa sasa ni thamani halali katika safu yako ya targets, pamoja na au badala ya zile za jumla.

Hakuna kinachobadilika katika jinsi unavyopiga API. Endpoint ile ile, muundo ule ule wa ombi. Una tu nambari zaidi halali za kuchagua.

Nini kimeongezwa

Nambari saba mpya za kikanda zifuatazo kiwango cha BCP-47:

Nambari	Lugha
`en-GB`	Kiingereza (Uingereza)
`fr-CA`	Kifaransa (Kanada)
`es-ES`	Kihispania (Hispania)
`es-MX`	Kihispania (Meksiko)
`pt-PT`	Kireno (Ureno)
`pt-BR`	Kireno (Brazil)
`zh-HK`	Kichina (Hong Kong)

Hizi ziko pamoja na zh-TW iliyopo (Kichina cha Kiasili), ambayo tayari ilikuwa ikitumia kanuni ile ile ya BCP-47. Kiasi cha malengo pia kimeongezwa kutoka 36 hadi 50 ili kuendana na timu zinazotumia lahaja nyingi za kikanda katika wito mmoja.

Kwa nini nambari za kikanda ni muhimu

Nambari za lugha za jumla (fr, pt, es) ni nzuri wakati hadhira yako ni pana au mchanganyiko. Lakini unapotoa bidhaa kwa nchi maalum, jumla mara nyingi haitoshi.

Kireno cha Brazil na Kireno cha Ulaya kinatofautiana katika msamiati, tahajia, na mtindo kwa njia zinazowahusu wazungumzaji asilia. Kihispania cha Meksiko na Kihispania cha Kastilia ni sawa vya kutosha kwamba tafsiri ya jumla haisomeki kama kigeni kwa yeyote wala si ya asili kabisa kwa yeyote pia. Kifaransa cha Kanada kina kanuni zake zinazotofautiana na Kifaransa cha Paris kwa njia zinazojulikana mara moja kwa mtu wa Quebec.

Kama unauza kwa soko maalum, soko hilo linastahili tafsiri iliyotengenezwa kwa ajili yao. Nambari za kikanda zinafanya iwezekane bila hitaji la wito tofauti wa API au mtiririko tofauti wa kazi.

Wito moja, lahaja nyingi

Nambari za jumla na za kikanda zinaweza kuwepo pamoja katika ombi moja. Kila moja hupata ufunguo wake katika jibu:

curl -sS -X POST "https://api.usepolylingo.com/v1/translate" \
  -H "Authorization: Bearer $POLYLINGO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Your order has been confirmed.",
    "targets": ["fr", "fr-CA", "pt", "pt-BR"]
  }'

{
  "translations": {
    "fr":    "Votre commande a été confirmée.",
    "fr-CA": "Votre commande a été confirmée.",
    "pt":    "O seu pedido foi confirmado.",
    "pt-BR": "O seu pedido foi confirmado."
  }
}

Unapata funguo nne kurudi, moja kwa kila nambari. Ikiwa fr na fr-CA zitatoa matokeo sawa kwa mfuatano fulani, hilo ni la kawaida — zitatofautiana katika msamiati na mtindo pale tofauti inapo kuwa na maana.

Kulenga soko maalum tu

Kama unajenga kwa soko linalojulikana na huna matumizi ya toleo la jumla, tuma tu nambari ya kikanda:

curl -sS -X POST "https://api.usepolylingo.com/v1/translate" \
  -H "Authorization: Bearer $POLYLINGO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Sign in to your account.",
    "targets": ["en-GB", "es-MX", "pt-BR", "zh-HK"]
  }'

Kujenga orodha ya malengo maalum ya soko katika Node.js

import { PolyLingo } from '@polylingo/node'

const client = new PolyLingo(process.env.POLYLINGO_API_KEY)

const result = await client.translate({
  content: 'Free shipping on orders over $50.',
  targets: ['es', 'es-MX', 'es-ES', 'pt', 'pt-BR', 'pt-PT'],
})

console.log(result.translations['es-MX']) // Kihispania cha Meksiko
console.log(result.translations['pt-BR']) // Kireno cha Brazil

Ombi moja linashughulikia masoko ya Amerika ya Kusini na Iberia. Hakuna mizunguko, hakuna kugawanya kwa kanda.

Kutafsiri faili za JSON kwa kila soko kwa Python

import os, requests

client = requests.Session()
client.headers['Authorization'] = f"Bearer {os.environ['POLYLINGO_API_KEY']}"

markets = {
    'latam':  ['es-MX', 'pt-BR'],
    'europe': ['en-GB', 'fr', 'es-ES', 'pt-PT', 'de', 'it'],
    'asia':   ['zh-HK', 'zh-TW', 'zh', 'ja', 'ko'],
}

content = '{"cta": "Start your free trial"}'

for region, targets in markets.items():
    r = client.post(
        'https://api.usepolylingo.com/v1/translate',
        json={'content': content, 'format': 'json', 'targets': targets},
        timeout=120,
    )
    r.raise_for_status()
    print(f"\n{region.upper()}")
    for code, text in r.json()['translations'].items():
        print(f"  {code}: {text}")

Kugundua nambari zinazotegemewa wakati wa utekelezaji

Kama unajenga chaguo la lugha au orodha ya malengo inayobadilika, huna haja ya kuweka nambari ngumu. GET /languages inarudisha orodha kamili ikiwa ni pamoja na lahaja zote za kikanda. Chuja kwa nambari zenye kiungo ili kupata lahaja hasa:

const res = await fetch('https://api.usepolylingo.com/v1/languages')
const { languages } = await res.json()

const dialects = languages.filter(l => l.code.includes('-'))
console.log(dialects)
// [
//   { code: 'en-GB', name: 'English (UK)',           rtl: false },
//   { code: 'fr-CA', name: 'French (Canada)',         rtl: false },
//   { code: 'es-ES', name: 'Spanish (Spain)',         rtl: false },
//   { code: 'es-MX', name: 'Spanish (Mexico)',        rtl: false },
//   { code: 'pt-PT', name: 'Portuguese (Portugal)',   rtl: false },
//   { code: 'pt-BR', name: 'Portuguese (Brazil)',     rtl: false },
//   { code: 'zh-TW', name: 'Chinese (Traditional)',  rtl: false },
//   { code: 'zh-HK', name: 'Chinese (Hong Kong)',     rtl: false },
// ]

Lini utumie nambari ya jumla vs ya kikanda

Tumia nambari ya jumla (pt, fr, es) wakati hadhira yako iko kijiografia mchanganyiko au haijulikani, unapokuwa unaanza tu na soko na unataka kufikia wengi, au wakati maudhui ni ya kiufundi kiasi kwamba tofauti za kikanda hazitakuwa na maana.

Tumia nambari ya kikanda (pt-BR, fr-CA, es-MX) unapotoa kwa nchi maalum, wakati uzoefu wa bidhaa umebinafsishwa kwa njia nyingine (bei, sarafu, muundo wa tarehe), wakati maudhui yako ni ya mazungumzo au ya uuzaji na mtindo unahitajika, au unapojua watumiaji wako wataona tofauti.

Mbinu zote mbili zinaweza kuwepo katika ombi moja. Mifano ya kawaida ni kutumia nambari ya jumla kama mbadala na nambari ya kikanda kwa uzoefu wa soko maalum, zote zikirudishwa katika jibu moja.

Hakuna kinachovunjika kwa watumiaji waliopo

Nambari zote za lugha zilizopo zinaendelea kufanya kazi kama zamani. Nambari mpya ni nyongeza. Ikiwa kwa sasa unapitisha fr utaendelea kupata matokeo yale yale. Ikiwa unataka Kifaransa cha Kanada hasa, ongeza fr-CA kwa malengo yako. Zinaweza kuwepo pamoja katika wito mmoja bila migongano.

Pata ufunguo wako wa API kwenye usepolylingo.com — kiwango cha bure kinajumuisha tokeni 50,000 kwa mwezi.