Qibla API, vidjet va sunʼiy intellekt konnektori

JSON API

Oʻnli graduslardagi lat va lon bilan yoki city bilan GET soʻrov yuboring: aholisi 15 000 va undan ortiq, koʻp tillarda yozilgan istalgan shahar. Bir nom bir nechta joyga tegishli boʻlsa, country qoʻshing.

https://awwab.app/api/qibla?lat=51.5074&lon=-0.1278
https://awwab.app/api/qibla?city=Karachi
https://awwab.app/api/qibla?city=Hyderabad&country=IN

Javobda haqiqiy shimoldan burchak, magnit kompasdagi burchak va bugungi magnit ogʻish, yoʻnalish, kilometr va mildagi masofa, bir qatorli jumla, muallif koʻrsatmasi va oʻsha joy uchun jonli kompas havolasi beriladi:

{
  "place_name": "Karachi",
  "bearing_true": 267.7,
  "bearing_magnetic": 266.4,
  "magnetic_declination": 1.3,
  "cardinal": "W",
  "distance_km": 2801,
  "distance_mi": 1740,
  "attribution": "Qibla direction by Awwab · https://awwab.app/qibla",
  "live_compass_url": "https://awwab.app/qibla?city=karachi"
}

Istalgan saytdan kesishgan manba soʻrovlariga ruxsat berilgan. Iltimos, soniyasiga taxminan bitta soʻrovdan oshirmang; tezroq mijozlar sekinlashtiriladi.

Sunʼiy intellekt yordamchilari

Awwab masofaviy MCP serverini yuritadi, shunda sunʼiy intellekt yordamchilari foydalanuvchilari uchun qiblani topib, Awwab nomini koʻrsata oladi. Kirish talab qilinmaydi.

https://awwab.app/mcp

Uning qibla vositasi find_qibla koordinatalar yoki shaharni qabul qiladi. ChatGPT ilovasida javob kichik kompas kartasi bilan keladi; Claude va boshqa yordamchilarda esa jonli kompasga oʻsha havola bilan matn va maʼlumot sifatida keladi. Sinab koʻrish uchun yuqoridagi manzilni Claude ilovasida maxsus konnektor sifatida yoki ChatGPT dasturchi rejimida ilova sifatida qoʻshing.

Oʻsha server yana ikkita vosita bilan Awwab Knowledge testini ishga tushiradi. start_quiz ixtiyoriy mavzu va tilni qabul qiladi hamda javobsiz besh savollik bir raundni qaytaradi; check_answer bitta javobni tekshiradi va izoh bilan manbalarini qaytaradi. Vidjetlarni qoʻllaydigan ilovalarda raund test kartasida oʻynaladi; boshqa mijozlarda esa matn va maʼlumot sifatida keladi. Natijalarda “Quiz by Awwab · awwab.app” muallifligi koʻrsatiladi.

SI ilovangizni ulang

Ilovangiz uchun sozlamani nusxalang. Ularning hammasi bir xil serverga ulanadi va kalit talab qilmaydi.

Claude (maxsus konnektor)

Claude’da Settings → Connectors → Add custom connector’ni oching va quyidagilarni toʻldiring:

Name: Awwab Qibla
URL:  https://awwab.app/mcp

Claude Code

claude mcp add --transport http awwab-qibla https://awwab.app/mcp

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "awwab-qibla": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://awwab.app/mcp"]
    }
  }
}

ChatGPT (dasturchi rejimi)

ChatGPT’da Settings → Apps → Advanced settings’ni oching, dasturchi rejimini yoqing, Create app’ni tanlang va quyidagilarni toʻldiring:

Name:                Awwab Qibla
MCP server URL:      https://awwab.app/mcp
Authentication:      No authentication

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "awwab-qibla": { "url": "https://awwab.app/mcp" }
  }
}

VS Code (.vscode/mcp.json)

{
  "servers": {
    "awwab-qibla": { "type": "http", "url": "https://awwab.app/mcp" }
  }
}

Gemini CLI (~/.gemini/settings.json)

{
  "mcpServers": {
    "awwab-qibla": { "httpUrl": "https://awwab.app/mcp" }
  }
}

OpenAI: Responses API va Agents SDK

// Responses API: a remote MCP tool
{
  "type": "mcp",
  "server_label": "awwab_qibla",
  "server_url": "https://awwab.app/mcp",
  "allowed_tools": ["find_qibla"],
  "require_approval": "never"
}

# Agents SDK (Python)
from agents import Agent
from agents.mcp import MCPServerStreamableHttp

async with MCPServerStreamableHttp(name="awwab-qibla", params={"url": "https://awwab.app/mcp"}) as qibla:
    agent = Agent(name="Assistant", mcp_servers=[qibla])

Topish

Server kartasi /mcp/server-card manzilida va /.well-known/ai-catalog.json roʻyxatida. JSON API GPT amallari va boshqa agent freymvorklari uchun OpenAPI 3.1 formatida tavsiflangan.

Masjidlar, maktablar va bloglar bir necha qator kod bilan qiblani oʻz sahifalarida koʻrsatishi mumkin. Qibla topuvchi sahifasida shahar yoki har bir tashrif buyuruvchining joylashuvi, yorugʻ yoki toʻq koʻrinish va tilni tanlang.

Maxfiylik

API yoki konnektorga yuborilgan koordinatalar va shaharlarni yozib olmaymiz va saqlamaymiz. Javobdan keyin hech narsa saqlanmaydi va cookie oʻrnatilmaydi. Suisteʼmolning oldini olish uchun Cloudflare har bir IP manzildan kelgan soʻrovlarni taxminan bir daqiqa davomida sanaydi. Toʻliq tafsilotlar maxfiylik siyosatimizda.

Raqamlar qanday hisoblanadi

Burchak — sferada joydan Kaʼbagacha (21.422487° sh. k., 39.826206° sh. u.) boʻlgan katta aylananing boshlangʻich yoʻnalishi; qibla odatda shunday hisoblanadi. Uning Yer ellipsoidi ustidagi hisobdan farqi yarim darajadan kam. Masofa Yerning oʻrtacha radiusi bilan hisoblanadi. Magnit ogʻish 2029-yil oxirigacha amal qiladigan World Magnetic Model 2025 dan olinadi.

Shartlar

Natija koʻrsatilgan har bir joyda “Qibla direction by Awwab” yozuvini awwab.app/qibla havolasi bilan koʻrsatish sharti bilan bepul. Shahar nomlari va joylashuvlari GeoNames manbasidan, CC BY 4.0 litsenziyasi ostida olingan; ulardan qayta foydalansangiz, GeoNames manbasini ham koʻrsating. Savollar: support@awwab.app.