naturalLanguages

About this parameter

Change the default of parameters for handling natural language searches as opposed to keyword searches, for example, for voice search.

The naturalLanguages parameter changes the following parameters and setttings:

• removeStopWords and ignorePlurals are set to the given list of languages.
• removeWordsIfNoResults is set allOptional.

• It adds the natural_language value to ruleContexts..

• It adds the natural_language value to analyticsTags.

Usage notes

• For optimal relevance, we recommend to only pass languages that occur in your data.

• List of supported languages with their associated language ISO code:

  Afrikaans=af Arabic=ar Azerbaijani=az Bulgarian=bg Bengali=bn Catalan=ca Czech=cs Welsh=cy Danish=da German=de Greek=el English=en Esperanto=eo Spanish=es Estonian=et Basque=eu Persian (Farsi)=fa Finnish=fi Faroese=fo French=fr Irish=ga Galician=gl Hebrew=he

  Hindi=hi Hungarian=hu Armenian=hy Indonesian=id Icelandic=is Italian=it Japanese=ja Georgian=ka Kazakh=kk Korean=ko Kurdish=ku Kirghiz=ky Lithuanian=lt Latvian=lv Maori=mi Mongolian=mn Marathi=mr Malay=ms Maltese=mt Norwegian Bokmål=nb Dutch=nl Norwegian=no Northern Sotho=ns

  Polish=pl Pashto=ps Portuguese=pt Brazilian=pt-br Quechua=qu Romanian=ro Russian=ru Slovak=sk Albanian=sq Swedish=sv Swahili=sw Tamil=ta Telugu=te Thai=th Tagalog=tl Tswana=tn Turkish=tr Tatar=tt Ukranian=uk Urdu=ur Uzbek=uz Chinese=zh

Examples

Set Natural Languages

In this example, we set French (fr) as the natural language.

At query time, ignorePlurals and removeStopWords are set to fr, and removeWordsIfNoResults is set to allOptional.

1
2
3
$index->search('', [
  'naturalLanguages' => ['fr']
]);

1
2
3
index.search('', {
    naturalLanguages: ['fr']
})

1
2
3
4
5
index.search('', {
  naturalLanguages: ['fr']
}).then(({ hits }) => {
  console.log(hits);
});

1
2
3
index.search('', {
    'naturalLanguages': ['fr']
})

1
2
3
4
5
6
7
8
let query = Query("query")
  .set(\.naturalLanguages, to: [.french])

index.search(query: query) { result in
  if case .success(let response) = result {
    print("Response: \(response)")
  }
}

1
2
3
4
5
6
7
val query = query("") {
    naturalLanguages {
        +French
    }
}

index.search(query)

1
2
3
4
index.Search<T>(new Query("")
{
    NaturalLanguages = new List<string> { "fr" }
});

1
2
index.search(
  new Query("").setNaturalLanguages(Collections.singletonList("fr"));

1
2
3
4
res, err := index.Search(
  "",
  opt.NaturalLanguages("fr")
)

1
2
3
4
5
6
client.execute {
  search into "myIndex" query Query(
    query = Some(""),
    naturalLanguages = Some(Seq("fr"))
  )
}

Override naturalLanguages with query parameters

In this example, we set French (fr) as a natural language, and we override removeWordsIfNoResults to firstWords.

At query time, both ignorePlurals and removeStopWords are set to fr, and removeWordsIfNoResults is set to firstWords because we explicitly pass it as a query parameter.

1
2
3
4
$index->search('', [
  'naturalLanguages' => ['fr'],
  'removeWordsIfNoResults' =>'firstWords'
]);

1
2
3
4
index.search('', {
    naturalLanguages: ['fr'],
    removeWordsIfNoResults: 'firstWords'
})

1
2
3
4
5
6
index.search('', {
  naturalLanguages: ['fr'],
  removeWordsIfNoResults: 'firstWords'
}).then(({ hits }) => {
  console.log(hits);
});

1
2
3
4
index.search('', {
    'naturalLanguages': ['fr'],
    'removeWordsIfNoResults': 'firstWords'
})

1
2
3
4
5
6
7
8
9
let query = Query("query")
  .set(\.naturalLanguages, to: [.french])
  .set(\.removeWordsIfNoResults, to: .firstWords)

index.search(query: query) { result in
  if case .success(let response) = result {
    print("Response: \(response)")
  }
}

1
2
3
4
5
6
7
8
val query = query("") {
    naturalLanguages {
        +French
    }
    removeWordsIfNoResults = RemoveWordIfNoResults.FirstWords
}

index.search(query)

1
2
3
4
5
index.Search<T>(new Query("")
{
    NaturalLanguages = new List<string> { "fr" },
    RemoveWordsIfNoResults = "firstWords"
});

1
2
3
4
5
index.search(
  new Query("")
  .setNaturalLanguages(Collections.singletonList("fr"))
  .setRemoveWordsIfNoResults(RemoveWordsType.REMOVE_FIRST_WORDS)
);

1
2
3
4
5
res, err := index.Search(
  "",
  opt.NaturalLanguages("fr"),
  opt.RemoveWordsIfNoResults("firstWords")
)

1
2
3
4
5
6
7
client.execute {
  search into "myIndex" query Query(
    query = Some(""),
    naturalLanguages = Some(Seq("fr")),
    removeWordsIfNoResults = Some(RemoveWordsIfNoResults.firstWords)
  )
}