"""Какие подложки можно взять без ключа? Справочник xyzservices.

Библиотека xyzservices (её использует folium) хранит сотни источников
тайлов. У каждого есть адрес, подпись об авторских правах (attribution)
и признак «нужен ли ключ» — метод requires_token().
Подложки CartoDB и Stadia/Stamen ключа формально не требуют, но, по опыту
нашего кружка, при открытии карты с диска на них появляется водяной знак
«API KEY REQUIRED», поэтому их мы тоже исключаем.
"""
from collections import Counter

import xyzservices.providers as xyz

providers = xyz.flatten()                      # {"Esri.WorldImagery": TileProvider, ...}
free = {name: p for name, p in providers.items()
        if not p.requires_token() and not name.startswith(("CartoDB", "Stadia", "Stamen"))}
print(f"Всего источников в xyzservices: {len(providers)}, без ключа: {len(free)}\n")

print("Больше всего бесплатных подложек у семейств:")
families = Counter(name.split(".")[0] for name in free)
for family, n in families.most_common(8):
    print(f"  {family:<18} {n}")

print("\nПроверенные в кружке подложки на весь мир:")
for name in ["OpenStreetMap.Mapnik", "OpenTopoMap", "Esri.WorldGrayCanvas",
             "Esri.WorldImagery", "Esri.WorldStreetMap", "Esri.WorldShadedRelief"]:
    p = free[name]
    print(f"  {name:<24} макс. зум {p.get('max_zoom', '—'):>2}   © {p.get('attribution', '')[:45]}")

print("\nКак подключить в folium:")
print('  folium.Map(tiles="Esri.WorldGrayCanvas")          # по имени')
print("  folium.Map(tiles=xyz.Esri.WorldGrayCanvas)        # объектом xyzservices")
