Najlepsze miejsca API
Porównaj rzeczywiste miasta z linią astrokartograficzną linii wybranej kategorii, dla jednego z dziewiętnastu obszarów życia. 34 028 miejsc z GeoNames, ocenionych według tego, jak blisko każde siedzi do linii, które obszar ten jest zbudowany z, z oddzielnymi raportowanymi stronami wsparcia i wyzwania.
Najlepsze miejsca API
Dla każdego miasta w puli endpoint mierzy odległość do każdej linii nazw kategorii wybranej, i wagi ją przez to, jak blisko pada. Odległość jest obliczana z godzinowego kąta i wysokości ciała zamiast przeciwko rysowanemu polinomowi, co czyni ją dokładną: odległość do linii wschodzącej lub zachodzącej jest wysokością ciała w stopniach łuku, ponieważ odległość zenitalna jest odległością wielokątną od punktu, nad którym stoi ciało; i offset linii południkowej jest godzinowym kątem w stopniach długości, co odległość powierzchniowa jest taki kąt razy kosinus szerokości geograficznej. Wpływ maleje liniowo do niczego na orbicie, 1126 km domyślnie, co jest 700 mil Jim Lewis użył. Wspierające i wyzwania łączne są oddzielone i każda linia wpływająca powraca z własną odległością, więc miejsce może być silne i turbulentne zamiast średniego.
POST/v1/acg/best-places
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/"
}
}
}Parametry
| name | type | Wymagane | |
|---|---|---|---|
| date | string (YYYY-MM-DD) | tak | Birth date. |
| time | string (HH:MM:SS) | tak | Local clock time at birth. |
| timezoneOffset | number (hours) | nie | UTC offset in effect at the birth moment. Defaults to 0. |
| category | string | tak | One of the 19 life categories. The list is at GET /v1/acg/categories. |
| countries | string[] (ISO 3166-1 alpha-2) | nie | Restrict the search. GET /v1/acg/countries lists what can be ranked and how many cities each country has. |
| minPopulation | number | nie | Floor on population. The bundled set starts at 15,000, so a lower value changes nothing. |
| orbKm | number | nie | How far a line reaches. Default 1126, the 700 miles Jim Lewis used. |
| minSeparationKm | number | nie | Keep results at least this far apart. Default 300. Set 0 for raw score order. |
| limit | number | nie | How many places to return. Default 25, maximum 100. |
| sort | "net" | "supportive" | nie | Ranking key. Net (default) subtracts the challenging total; supportive ignores it for ordering only, never for reporting. |
Kiedy używać
Użyj go, gdy użytkownik zada oczywistą następną pytaniami. Astrokartografia rysuje linie i filtr kategorii mówi, które linie mają znaczenie dla pieniędzy lub miłości; to mówi, gdzie się faktycznie pójść. Jest to różnica między mapą a odpowiedzią. W produkcie, karmić wynik bezpośrednio do krótkiej listy: każde miejsce nosi swoje koordynaty, populację, czasową strefę, i dokładne linie, które go tam umieściły z odległościami w kilometrach, co może być pokazane zamiast twierdzeniem. Miejsce urodzenia nie jest potrzebne i nie jest używane, ponieważ linie należą do momentu urodzenia.
Uwagi
Cieniowanie nie jest estetyczne. Linia astrokartograficzna jest krzywą, więc każde osadzenie wzdłuż niej zdobywa niemal takie same, i bez rozprzestrzeniania wyników, top dziesięć dla kariery powróciło jako dziesięć norweskich miast wewnątrz 70 km, dwie z nich były dzielnicami trzeciego. Ustaw `minSeparationKm` na 0, aby zobaczyć oryginalny porządek. **To nie jest geokodowaniem.** Lista miast jest zgrupowana i zaczyna się od 15 000 ludzi: mniejsze miasto jest nieobecne w rankingu zamiast niskiego rankingu, i niezmienna nazwa miejsca nie może być rozwiązana. Aby ocenić konkretny punkt swojego, przesłać jego koordynaty do endpointów stref astrokartograficznych zamiast tego. Nazwy miast, koordynaty i populacje pochodzą z GeoNames, bazy danych geograficznej, używanej pod licencją CC BY 4.0; pokazywanie ich przynosi to samo zezwolenie, co dlatego atrybut jest dostarczany w każdym ciele odpowiedzi zamiast tylko tutaj.
Wypróbuj API Najlepsze miejsca
Zdobądź klucz i wykonaj pierwsze wywołanie w niecałą minutę.