GET/api/astro/geocode/1 kredi

Yer arama

Bir yer adını, diğer endpoint'lerin ihtiyaç duyduğu koordinatlara ve UTC farkına çevirir. 'Jaipur, India' gibi bir `address` sorgu parametresiyle GET isteği gönderin; yanıtta `latitude`, `longitude`, IANA `timezone_name`, saat cinsinden ondalık sayı olarak `timezone_offset`, coğrafi kodlama servisinin döndürdüğü `address` string'i ve yanıtı veren servisi gösteren `source` bulunur. Sağlayıcı bildiriyorsa fark yaz saatini zaten içerir; yani bu, geçmişteki bir doğum tarihinde geçerli olan fark değil, o yerin bugünkü farkıdır. Doğum haritası için bu koordinatları gerçek tarihle birlikte /api/astro/date_time/ endpoint'ine gönderin ve doğru an için farkı o endpoint'in belirlemesine bırakın. `source` hangi sağlayıcının yanıt verdiğini gösterir: dağıtımda bir Google Maps anahtarı tanımlıysa 'google', değilse yedek olarak kullanılan OpenStreetMap servisi 'nominatim'. Bulunamayan bir yer 404, eksik `address` ise 400 döndürür.

https://api.occultapi.com/api/astro/geocode/

İsteği deneyin

Kimlik doğrulama

Anahtarınızı X-API-Key başlığında gönderin. Anahtar, sunucu tarafında saklanması gereken bir kimlik bilgisidir; tarayıcıda çalışan JavaScript'e veya mobil uygulamaya asla koymayın.

X-API-Key: yt_live_a1b2c3d4_…

Sorgu parametreleri (1)

URL'de gönderilir. Aksi belirtilmedikçe hepsi isteğe bağlıdır ve birlikte kullanılabilir: önce filtreleme, sonra sayfalama, en son sıralama uygulanır.

Parametre	Tür		Örnek	Ne işe yarar
address	string	zorunlu	`Jaipur, Rajasthan, India`	Aranacak şehir/yer adı Aranacak yer adı. Serbest metin - genellikle şehir adı yeterlidir; karışıklığı önlemek için eyalet veya ülke ekleyin.

Örnek istek

curl "https://api.occultapi.com/api/astro/geocode/?address=Jaipur" \
  -H "X-API-Key: $OCCULT_API_KEY"

Yanıt

{
  "address": "Jaipur, Rajasthan, India",
  "latitude": 26.9124336,
  "longitude": 75.7872709,
  "timezone_name": "Asia/Calcutta",
  "timezone_offset": 5.5,
  "source": "google"
}

Yukarıdaki isteğin birebir aynısıyla yapılan gerçek bir çağrıdan alındı. Sonuçlar data altında yer alır.

Hatalar

Kredi ve kullanım hataları { "error": "…", "message": "<code>", "is_error": true } döndürür. Kullanıcıya error değerini gösterin, kodunuzda ise message değerine göre karar verin. Ayrıntılar için hata referansına bakın.