API για προγραμματιστές

Ένα δωρεάν, τεκμηριωμένο REST API για γεωκωδικοποίηση, αντίστροφη γεωκωδικοποίηση, αναζήτηση ζώνης ώρας, υψόμετρο και ώρες ήλιου και σελήνης — τα ίδια proxies με σεβασμό στο απόρρητο που χρησιμοποιεί αυτός ο ιστότοπος. Χωρίς πιστωτική κάρτα· το κλειδί εκδίδεται άμεσα και εμφανίζεται μία μόνο φορά.

1000 αιτήματα/ημέρα · 60 ανά λεπτό

Αποκτήστε το δωρεάν κλειδί σας

Όνομα

Τι θα φτιάξετε; (προαιρετικά)

Πληκτρολογήστε τον κωδικό που εμφανίζεται

Δεν διαβάζεται; Ανανεώστε τη σελίδα για νέο κωδικό. Η επαλήθευση γίνεται στον διακομιστή μας — χωρίς υπηρεσία captcha τρίτων, τίποτα δικό σας δεν φεύγει από αυτόν τον ιστότοπο.

Χρησιμοποιούμε το email σας μόνο για να επικοινωνήσουμε μαζί σας σχετικά με ασύμβατες αλλαγές του API ή με κατάχρηση. Χωρίς newsletter, χωρίς μεταπώληση.

Endpoints

Endpoint	Τι κάνει	Παράδειγμα
`GET /api/v1/geocode`	Διεύθυνση / τόπος → συντεταγμένες (5 καλύτερες αντιστοιχίες)	`?q=Eiffel+Tower`
`GET /api/v1/reverse-geocode`	Συντεταγμένες → διεύθυνση	`?lat=48.858&lng=2.294`
`GET /api/v1/timezone`	Συντεταγμένες → ζώνη ώρας IANA + διαφορά UTC	`?lat=28.61&lng=77.21`
`GET /api/v1/elevation`	Συντεταγμένες → υψόμετρο εδάφους (Copernicus DEM)	`?lat=27.99&lng=86.93`
`GET /api/v1/sun-times`	Ανατολή, δύση, λυκαυγές, λυκόφως, διάρκεια ημέρας	`?lat=51.5&lng=-0.12&date=2026-07-19`
`GET /api/v1/moon`	Φάση σελήνης, φωτισμός, ανατολή/δύση σελήνης	`?lat=51.5&lng=-0.12`

Ταυτοποίηση: στείλτε το κλειδί ως κεφαλίδα X-Api-Key (προτιμότερο) ή ως παράμετρο ?key=. Κάθε απόκριση περιλαμβάνει X-RateLimit-Remaining-Today. Τα σφάλματα επιστρέφονται σε JSON με κωδικό error. Δεδομένα γεωκωδικοποίησης © OpenStreetMap contributors (ODbL) — αποθηκεύστε τα αποτελέσματα σε cache αντί να επαναλαμβάνετε τα ερωτήματα και εμφανίζετε την αναφορά προέλευσης στις εφαρμογές τελικών χρηστών.

Γρήγορη εκκίνηση

# 1. Γεωκωδικοποίηση διεύθυνσης
curl -H "X-Api-Key: wiml_YOURKEY" "https://whatismylocation.ai/api/v1/geocode?q=Taj+Mahal"

# 2. Αντίστροφη γεωκωδικοποίηση
curl -H "X-Api-Key: wiml_YOURKEY" "https://whatismylocation.ai/api/v1/reverse-geocode?lat=27.1751&lng=78.0421"

# 3. Ώρες ήλιου για σήμερα
curl -H "X-Api-Key: wiml_YOURKEY" "https://whatismylocation.ai/api/v1/sun-times?lat=27.1751&lng=78.0421"

Θεμιτή χρήση: η δωρεάν βαθμίδα υπάρχει για πρωτότυπα, πράκτορες και μικρές εφαρμογές. Χρειάζεστε περισσότερα; Επικοινωνήστε μαζί μας.

Για πράκτορες AI

Αυτό το API είναι το επίσημο endpoint για μηχανές που αντιστοιχεί στα εργαλεία αυτού του ιστότοπου (δηλώνεται επίσης σε llms.txt και ai.json). Οι πράκτορες είναι ευπρόσδεκτοι στην ίδια δωρεάν βαθμίδα — δηλώστε τον πράκτορά σας στο πεδίο σκοπού κατά την εγγραφή.

Προχωρημένο εργαλείο: μαζική γεωκωδικοποίηση

Έχετε ένα CSV με διευθύνσεις (ή συντεταγμένες); Το εργαλείο μαζικής γεωκωδικοποίησης επεξεργάζεται έως 500 γραμμές μέσω αυτού του API μέσα στο πρόγραμμα περιήγησής σας με το κλειδί σας — με ήπια ουρά ~1 αίτημα/δευτερόλεπτο, αποτελέσματα με δυνατότητα λήψης σε CSV ή GeoJSON, και το αρχείο σας δεν φτάνει ποτέ στον διακομιστή μας. Για εργασίες πάνω από μερικές χιλιάδες γραμμές, χρησιμοποιήστε εμπορικό geocoder αντί για δωρεάν κοινοτικό.