Отправьте один вызов API со ста адресами внутри, и этот вызов израсходует сто запросов, а не один. Мы считаем каждый элемент массового или пакетного запроса по отдельности. Правило простое, но его стоит чётко проговорить, потому что от него зависит, как планировать пакетное задание и закладывать на него бюджет.
Логика становится очевидной, если подумать, что на самом деле делает пакетный вызов. Один HTTP-запрос, который геокодирует сто адресов, выполняет на нашей стороне сто единиц работы: сто поисков, сто ответов, сто строк в ответе. Если брать за это плату как за один запрос, пришлось бы брать долю цента за то, что на самом деле является сотней отдельных порций информации. Подсчёт по элементам привязывает цену к фактически выполненной работе, а не к тому, сколько раз вы открыли соединение.
Это работает одинаково, находитесь ли вы в пределах бесплатного уровня или платите за использование. Если у вашей сети в дневном бесплатном лимите осталось 400 запросов и вы отправляете пакет из 1 000 адресов, 400 из этих элементов покрываются бесплатным лимитом, а оставшиеся 600 списываются с предоплаченного баланса или пакета Unlimited. Заголовки квоты в ответе отражают это в точности: X-Quota-Used увеличивается на число элементов, а не на число вызовов, а X-Credits-Remaining отражает всё, что пакет израсходовал сверх бесплатной части.
Это также значит, что нет никакого смысла дробить работу на множество мелких вызовов, чтобы обойти квоту, и нет никакого штрафа за объединение работы в меньшее число крупных. Сто вызовов по одному элементу и один вызов на сто элементов стоят одинаково и учитываются одинаково. Выбирайте ту форму, которую вашему коду проще писать, а инфраструктуре проще выполнять. Некоторые команды предпочитают много мелких вызовов, потому что так проще повторить неудачный. Другие предпочитают один крупный вызов, потому что так меньше обращений туда и обратно. Цена у обоих вариантов одинаковая.
Для планирования это делает расчёт мощностей простым. Если ежедневному заданию нужно обработать 50 000 адресов, это 50 000 запросов, и точка, независимо от того, отправлены они одним вызовом, десятью или пятьюстами. При цене 0,0001 € за запрос сверх бесплатного лимита такой расчёт на бумаге занимает секунды.
Каждый эндпоинт и каждый совместимый хост используют одинаковый поэлементный подсчёт для пакетных и массовых операций. Нет ни отдельного, более дешёвого пакетного тарифа, ни отдельного, более дорогого. Поиск стоит одинаково, приходит ли он сам по себе или в списке из тысячи других.
Если вы создаёте пакетное задание для My Geocode, планируйте объём запросов, считая отправляемые адреса, координаты или IP, а не число HTTP-вызовов, в которых они передаются. Именно это число отображается в вашей квоте, и именно его отразит любой счёт.
Обзор последних работ по всему API: новые совместимые хосты, более быстрое определение часового пояса и высоты, новые функции личного кабинета и более наглядная информация о квоте.
Организации с собственными требованиями к соответствию теперь могут запросить соглашение об обработке данных, описывающее, как My Geocode обращается с персональными данными.
Ключи нового аккаунта продолжают работать в течение льготного периода после регистрации и приостанавливаются, только если адрес электронной почты так и не будет подтверждён в этот срок.