Страны, рынки и языки в Bing: mkt, cc и setlang

Регион выдачи Bing задаётся тремя параметрами: mkt - рынок, пара «язык-страна», cc - страна, setlang - язык интерфейса. Ниже - что делает каждый и полные списки поддерживаемых значений: 71 рынков, 236 стран и 34 языков.

Рынок задаёт выдачу, страна её уточняет

Регион нужно задавать явно. Если не передать ничего, Bing определит его сам, и какой он получится - не гарантировано: фактический рынок приходит в ответе полем mkt, и он может не совпасть с ожидаемым. Предсказуемый результат даёт только явно указанный рынок.

Одного cc для смены страны мало - без рынка он выдачу почти не меняет. Страна работает в паре с региональным рынком, тем, что покрывает несколько стран сразу: mkt=ar-XA&cc=QA даёт qatar-tribune.com и lusailnews.net, а cc=KW при том же рынке - arabtimesonline.com и alqabas.com.

Внутри странового рынка уточнять нечего, и cc там ничего не меняет: mkt=en-US с cc=NG и без него отдаёт одну и ту же выдачу.

Отсюда порядок: сначала рынок, затем страна - если рынок региональный. Есть рынок нужной страны - достаточно одного mkt.

Что с чем сочетается

Когда параметры противоречат друг другу, побеждает не тот, что стоит раньше в запросе. Проверено замерами: каждому параметру давалась своя страна, и по выдаче видно, чью сторону взял Bing. Выдача от запроса к запросу слегка плавает, поэтому каждый случай прогонялся по три раза и сравнивались наборы адресов целиком - иначе шум легко принять за влияние параметра.

Последняя строка - важная тонкость. setlang задаёт язык интерфейса и переписывает поле mkt в ответе: на mkt=ja-JP&setlang=de вернётся mkt=de-DE, хотя ранжирование осталось японским. Судить о стране выдачи по этому полю, когда передан setlang, нельзя.

Координаты

Координаты (ll) задают место точнее всего остального и перебивают по нему и рынок, и страну. Город, который Bing из них вычислил, приходит в поле region ответа: ll=55.7558,37.6173 - «Москва, Москва», ll=43.5855,39.7231 - «Сочи, Краснодарский край». Проверено на шести городах - от Калининграда до Владивостока, - и каждый определился со своей областью.

На локальных запросах это меняет и состав выдачи: по запросу «доставка пиццы» две разные точки дают почти непересекающиеся списки (совпадение около 0.2 при 0.9 у двух запросов с одной и той же точки). Рынок при этом никуда не девается - он продолжает отвечать за язык и за то, из какой страны Bing предпочитает источники. Координаты отвечают на вопрос «где», mkt - на вопрос «чья выдача».

Текстовый адрес (name, city, state) так не работает: эти поля Bing не читает, и место остаётся тем, что он определил по адресу выхода в интернет. Единственный рабочий способ указать точку - координаты.

Рынки: 71 пар «язык-страна»

Рынок - основной способ сказать Bing, чью выдачу вы хотите. Формат язык-СТРАНА: ru-RU, en-US, bn-BD. Первое - язык интерфейса и приоритет для языка документов, второе - страна ранжирования.

Список рынков у Bing свой и заметно короче списка стран: не у каждой страны он есть. Ниже полный перечень, сгруппированный по языку.

Как отличить настоящий рынок от выдуманного

Bing не отвечает ошибкой на несуществующий рынок - он молча подставляет ближайший. Со стороны это выглядит как работающий запрос, хотя выдача пришла не та, о которой просили.

Отличить можно по ответу: Bing возвращает в нём фактический рынок, и мы отдаём его полем mkt. Попросили bn-BD, в ответе bn-BD - рынок настоящий. Попросили ar-QA, в ответе ar-XA - такого рынка у Bing нет, запрос увели на общий арабский.

Проверять это через наш API не нужно: несуществующий рынок он отклоняет ошибкой 422, не доходя до поисковика. В списке выше только те, что Bing принимает.

Страны: 236 кодов

Параметр cc - двухбуквенный код страны по ISO 3166-1 alpha-2. Кроме них в списке есть два кода самого Bing, странам не принадлежащие: XA - Аравия и XL - Латинская Америка. Это регионы его рынков, и в cc они оставлены для совместимости.

Страна уточняет выдачу внутри регионального рынка и особенно полезна там, где своего рынка у страны нет.

Катар, Иордания, Оман, Кувейт, Бахрейн, Ирак, Марокко - своих рынков у них нет, но cc работает: с mkt=ar-XA и нужным cc выдача становится местной. То же с Нигерией и Кенией через en-XA или en-US.

Полный список - ровно тот, что Bing предлагает в своих настройках в переключателе «Страна или регион».

Языки интерфейса: 34

setlang задаёт язык интерфейса и подписей. Регион он не меняет и совместим с любым из параметров выше - его можно добавлять к чему угодно. Полезен, когда выдача нужна страновая, а читать служебные надписи удобнее на своём языке.

Что выбрать под задачу

• Есть рынок страны - передавайте только mkt. Например mkt=bn-BD для Бангладеш или mkt=vi-VN для Вьетнама.
• Рынка нет - берите ближайший общий и уточняйте страной: mkt=ar-XA&cc=QA для Катара, mkt=en-XA&cc=NG для Нигерии.
• Язык надписей отдельно от региона - setlang.

Если передать несколько параметров локации сразу, Bing возьмёт верхний по списку из документации, остальные проигнорирует.

Примеры

curl "https://jsonseo.ru/api/bing?text=local+news&mkt=bn-BD&key=ВАШ_КЛЮЧ"
curl "https://jsonseo.ru/api/bing?text=local+news&mkt=ar-XA&cc=QA&key=ВАШ_КЛЮЧ"
curl "https://jsonseo.ru/api/bing?text=pizza&ll=55.753930,37.620795&key=ВАШ_КЛЮЧ"

Таблицы строятся из того же справочника, по которому API проверяет параметры mkt, cc и setlang. Список стран совпадает с переключателем «Страна или регион» в настройках Bing.