सबसे अच्छी जगहें API

पूल के हर शहर के लिए endpoint चुनी गई श्रेणी की हर रेखा से दूरी मापता है और उसे निकटता के अनुसार वज़न देता है। दूरी खींची गई polyline के बजाय पिंड के hour angle और altitude से निकाली जाती है, जिससे वह सटीक होती है: rising या setting रेखा की दूरी पिंड की altitude डिग्री में होती है, क्योंकि zenith दूरी उस बिंदु से great-circle दूरी होती है जिसके ऊपर पिंड खड़ा है; और meridian रेखा का offset hour angle डिग्री longitude में होता है, इसलिए ज़मीनी दूरी वह गुणा latitude का cosine होती है। प्रभाव orb तक रैखिक रूप से घटकर शून्य हो जाता है, डिफ़ॉल्ट रूप से 1126 km, जो Jim Lewis की 700 मील है। सहायक और चुनौतीपूर्ण योग अलग रखे जाते हैं और हर योगदान देने वाली रेखा अपनी दूरी के साथ लौटती है, इसलिए कोई जगह मज़बूत और अशांत दोनों हो सकती है, बीच में औसत होने के बजाय। फिर परिणाम इस तरह पतले किए जाते हैं कि कोई दो 300 km के भीतर न हों, और दबाई गई संख्या रिपोर्ट की जाती है।

curl -X POST https://api.astroway.info/v1/acg/best-places \
  -H "X-Api-Key: aw_live_..." \
  -H "Content-Type: application/json" \
  -d '{
  "date": "1990-05-15",
  "time": "14:30:00",
  "timezoneOffset": 3,
  "category": "career",
  "limit": 10
}'

{
  "ok": true,
  "data": {
    "type": "acg-best-places",
    "orbKm": 1126,
    "minSeparationKm": 300,
    "suppressedAsTooClose": 99,
    "maxPossibleSupportive": 12,
    "pool": { "citiesConsidered": 34028, "citiesWithAnyLine": 13589 },
    "places": [
      {
        "name": "Ålesund",
        "country": "Norway",
        "countryCode": "NO",
        "lat": 62.4723,
        "lon": 6.1549,
        "population": 46747,
        "supportive": 3.2529,
        "challenging": 0,
        "net": 3.2529,
        "supportivePercent": 27.1,
        "lines": [
          {
            "planetName": "Sun",
            "angle": "MC",
            "weight": 3,
            "polarity": "supportive",
            "distanceKm": 22,
            "contribution": 2.9414
          }
        ]
      }
    ],
    "attribution": {
      "source": "GeoNames",
      "licence": "CC BY 4.0",
      "licenceUrl": "https://creativecommons.org/licenses/by/4.0/"
    }
  }
}

इसका उपयोग तब करो जब यूज़र ने अगला स्पष्ट सवाल पूछ लिया हो। Astrocartography रेखाएँ खींचता है और category filter बताता है कि पैसे या प्यार के लिए कौन सी मायने रखती हैं; यह बताता है कि असल में कहाँ जाना है। यह नक्शे और जवाब के बीच का फर्क है। किसी प्रोडक्ट में, परिणाम सीधे shortlist में डालो: हर जगह के साथ उसके निर्देशांक, जनसंख्या, timezone और वे सटीक रेखाएँ होती हैं जिन्होंने उसे वहाँ पहुँचाया, किलोमीटर में दूरियों सहित, ताकि तर्क दिखाया जा सके, सिर्फ दावा न किया जाए। जन्म स्थान की ज़रूरत नहीं है और उसका उपयोग नहीं होता, क्योंकि रेखाएँ जन्म के क्षण की होती हैं।

पतला करना सिर्फ सौंदर्य के लिए नहीं है। Astrocartography रेखा एक वक्र होती है, इसलिए उसके साथ हर बस्ती लगभग समान स्कोर पाती है, और परिणाम फैलाए बिना करियर की टॉप टेन 70 km के भीतर दस नॉर्वेजियन शहर आते थे, जिनमें से दो तीसरे के ज़िले थे। कच्चा क्रम देखने के लिए `minSeparationKm` को 0 पर सेट करो। **यह geocoding नहीं है।** शहरों की सूची बंडल की गई है और 15,000 लोगों से शुरू होती है: छोटा शहर खराब रैंक होने के बजाय रैंकिंग से गायब है, और मनमाने नाम को resolve नहीं किया जा सकता। अपने किसी खास बिंदु को स्कोर करने के लिए, उसके निर्देशांक astrocartography zones endpoint को दो। शहरों के नाम, निर्देशांक और जनसंख्या GeoNames भौगोलिक डेटाबेस से आते हैं, CC BY 4.0 के तहत उपयोग किए गए; उन्हें दिखाने पर वही श्रेय लागू होता है, इसलिए attribution हर response body में शामिल है, सिर्फ यहाँ नहीं।