https://github.com/go-api-libs/iss-location
Go library for the ISS Current Location. Provides the current location of the International Space Station (including latitude, longitude, and timestamp) and a list of people currently in space. Users are advised to poll the API no more than once every 5 seconds.
https://github.com/go-api-libs/iss-location
api api-client api-library astronauts astronomy go golang gps integration international-space-station iss-location iss-location-api isslocation openapi openapi3 space
Last synced: about 1 year ago
JSON representation
Go library for the ISS Current Location. Provides the current location of the International Space Station (including latitude, longitude, and timestamp) and a list of people currently in space. Users are advised to poll the API no more than once every 5 seconds.
- Host: GitHub
- URL: https://github.com/go-api-libs/iss-location
- Owner: go-api-libs
- License: mit
- Created: 2024-12-22T11:01:31.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-01-19T19:18:43.000Z (about 1 year ago)
- Last Synced: 2025-01-19T20:20:41.852Z (about 1 year ago)
- Topics: api, api-client, api-library, astronauts, astronomy, go, golang, gps, integration, international-space-station, iss-location, iss-location-api, isslocation, openapi, openapi3, space
- Homepage:
- Size: 621 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 🛰️ ISS Current Location
[](https://pkg.go.dev/github.com/go-api-libs/iss-location/pkg/isslocation)
[](http://open-notify.org)
[](/api/openapi.json)
[](https://goreportcard.com/report/github.com/go-api-libs/iss-location)
[](./LICENSE)
Provides the current location of the International Space Station (including latitude, longitude, and timestamp) and a list of people currently in space. Users are advised to poll the API no more than once every 5 seconds.
## Installation
To install the library, use the following command:
```shell
go get github.com/go-api-libs/iss-location/pkg/isslocation
```
## Usage
### Example 1: Get the current location of the International Space Station
```go
package main
import (
"context"
"github.com/go-api-libs/iss-location/pkg/isslocation"
)
func main() {
c, err := isslocation.NewClient()
if err != nil {
panic(err)
}
ctx := context.Background()
issLocation, err := c.GetIssLocation(ctx)
if err != nil {
panic(err)
}
// Use issLocation object
}
```
### Example 2: Get a list of astronauts currently in space
```go
package main
import (
"context"
"github.com/go-api-libs/iss-location/pkg/isslocation"
)
func main() {
c, err := isslocation.NewClient()
if err != nil {
panic(err)
}
ctx := context.Background()
peopleInSpace, err := c.GetPeopleInSpace(ctx)
if err != nil {
panic(err)
}
// Use peopleInSpace object
}
```
## Additional Information
- [**Go Reference**](https://pkg.go.dev/github.com/go-api-libs/iss-location/pkg/isslocation): The Go reference documentation for the client package.
- [**Official Documentation**](http://open-notify.org): The official API documentation.
- [**OpenAPI Specification**](./api/openapi.json): The OpenAPI 3.1.0 specification.
- [**Go Report Card**](https://goreportcard.com/report/github.com/go-api-libs/iss-location): Check the code quality report.
## Contributing
If you have any contributions to make, please submit a pull request or open an issue on the [GitHub repository](https://github.com/go-api-libs/iss-location).
## License
This project is licensed under the MIT License. See the [LICENSE](./LICENSE) file for details.