API na alƙibla, widget da mahaɗin AI

API na JSON

Ku aika buƙatar GET tare da lat da lon a digiri na goma-goma, ko tare da city: kowane gari mai mutane 15,000 ko fiye, a rubuce cikin harsuna da yawa. Ku ƙara country idan wurare da yawa suna da suna ɗaya.

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

Amsar tana ba da digiri daga arewa ta gaskiya, digiri a kamfas na maganadisu da karkatar maganadisu ta yau, fuska, nisa a kilomita da mil, jumla ta layi ɗaya, layin ambato, da mahaɗi zuwa kamfas kai tsaye na wannan wurin:

{
  "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"
}

An yarda da buƙatu daga kowane shafi. Don Allah ku tsaya kan kusan buƙata ɗaya a cikin daƙiƙa; ana rage saurin masu sauri.

Mataimakan AI

Awwab yana gudanar da sabar MCP mai nisa, domin mataimakan AI su nemo alƙibla ga masu amfani da su kuma su ambaci Awwab. Ba a bukatar shiga.

https://awwab.app/mcp

Kayan aikinsa na alƙibla, find_qibla, yana karɓar daidaitawa ko gari. A ChatGPT amsar tana zuwa tare da ƙaramin katin kamfas; a Claude da sauran mataimaka tana zuwa a matsayin rubutu da bayanai tare da mahaɗi ɗaya zuwa kamfas kai tsaye. Don gwadawa, ku ƙara adireshin da ke sama a matsayin mahaɗi na musamman a Claude, ko a matsayin manhaja a yanayin masu haɓaka na ChatGPT.

Sabar ɗaya tana gudanar da tambayoyin Awwab Knowledge da ƙarin kayan aiki biyu. start_quiz yana karɓar jigo da harshe idan an so, sannan yana dawo da zagaye na tambayoyi biyar ba tare da amsoshinsu ba; check_answer yana duba amsa ɗaya, sannan yana dawo da bayani da majiyoyinsa. A manhajojin da ke tallafa wa widget, ana yin zagayen a cikin katin tambayoyi; a sauran kuma yana zuwa a matsayin rubutu da bayanai. Sakamakon yana ɗauke da ambaton “Quiz by Awwab · awwab.app”.

Haɗa manhajar AI ɗinku

Ku kwafi saitin manhajarku. Dukansu suna nuna sabar ɗaya kuma ba sa bukatar maɓalli.

Claude (mahaɗi na musamman)

A Claude, ku buɗe Settings → Connectors → Add custom connector, sannan ku cike:

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 (yanayin masu haɓakawa)

A ChatGPT, ku buɗe Settings → Apps → Advanced settings, ku kunna yanayin masu haɓakawa, ku zaɓi Create app, sannan ku cike:

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 da 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])

Ganowa

Katin sabar yana a /mcp/server-card kuma an jera shi a /.well-known/ai-catalog.json. An bayyana JSON API a OpenAPI 3.1, domin ayyukan GPT da sauran tsarin wakilai.

Widget

Masallatai, makarantu da bulogi za su iya nuna alƙibla a shafukansu da 'yan layukan lamba. Ku zaɓi gari ko wurin kowane baƙo, kamanni mai haske ko mai duhu, da harshe a shafin mai nemo alƙibla.

Sirri

Ba ma rubutawa ko adana daidaitawa ko garuruwan da aka aika zuwa API ko mahaɗin. Ba a adana komai bayan amsa, kuma ba a saka kukis. Don hana cin zarafi, Cloudflare yana ƙirga buƙatu daga kowane adireshin IP na kusan minti ɗaya. Cikakken bayani yana cikin manufar sirrinmu.

Yadda ake lissafin lambobin

Digirin shi ne fuskar farko ta babban da'ira daga wurin zuwa Ka'aba (21.422487° arewa, 39.826206° gabas) a kan kewayayyen fasali, kuma haka ake lissafin alƙibla akasari. Bambancinsa da lissafi a kan siffar duniya ta gaske bai kai rabin digiri ba. Ana lissafin nisa da matsakaicin radiyon duniya. Karkatar maganadisu tana fitowa daga World Magnetic Model 2025, wanda yake aiki har ƙarshen 2029.

Sharuɗɗa

Kyauta ne, bisa sharaɗin ku ambaci “Qibla direction by Awwab” tare da mahaɗi zuwa awwab.app/qibla a duk inda aka nuna sakamakon. Sunaye da wuraren garuruwa sun fito daga GeoNames ƙarƙashin CC BY 4.0; ku ambaci GeoNames ma idan kun sake amfani da su. Tambayoyi: support@awwab.app.