{"id":22620316,"url":"https://github.com/qba73/iss","last_synced_at":"2025-03-29T02:13:02.938Z","repository":{"id":50704568,"uuid":"519889426","full_name":"qba73/iss","owner":"qba73","description":"International Space Station Go client","archived":false,"fork":false,"pushed_at":"2022-09-14T04:43:44.000Z","size":27,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-02-03T12:16:40.974Z","etag":null,"topics":["api-client","earth-observation","gis","gis-data","go","golang-library","spacestation"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/qba73.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2022-07-31T21:19:37.000Z","updated_at":"2022-07-31T21:44:11.000Z","dependencies_parsed_at":"2022-08-25T14:41:19.563Z","dependency_job_id":null,"html_url":"https://github.com/qba73/iss","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/qba73%2Fiss","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/qba73%2Fiss/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/qba73%2Fiss/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/qba73%2Fiss/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/qba73","download_url":"https://codeload.github.com/qba73/iss/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246126720,"owners_count":20727594,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api-client","earth-observation","gis","gis-data","go","golang-library","spacestation"],"created_at":"2024-12-08T22:13:10.573Z","updated_at":"2025-03-29T02:13:02.916Z","avatar_url":"https://github.com/qba73.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![GoDoc](https://godoc.org/github.com/qba73/iss?status.png)](http://godoc.org/github.com/qba73/iss)\n![Go](https://github.com/qba73/iss/workflows/Go/badge.svg)\n[![Go Report Card](https://goreportcard.com/badge/github.com/qba73/iss)](https://goreportcard.com/report/github.com/qba73/iss)\n![GitHub](https://img.shields.io/github/license/qba73/iss)\n![GitHub go.mod Go version](https://img.shields.io/github/go-mod/go-version/qba73/iss)\n\n# ISS\n\nISS is a Go library for the the [International Space Station](https://en.wikipedia.org/wiki/International_Space_Station) API. It allows to get station's current lat and long coordinates.\n\n## Using the Go library\n\nImport the library using\n\n```go\nimport github.com/qba73/iss\n```\n\n## Creating a client\n\nCreate a new client object by calling ```iss.New()```\n\n```go\nclient, err := iss.New()\nif err != nil {\n  // handle error\n}\n```\n\nIf you  want to use your ```http.Client```\n\n```go\nhttpClient := http.Client{}\nissClient, err := iss.New(iss.WithHTTPClient(\u0026httpClient))\nif err != nil {\n  // handle error\n}\n\nlat, long, err := issClient.GetPosition()\nif err != nil {\n  // handle error\n}\n\n```\n\n## Retrieving ISS coordinates using client\n\n```go\nclient, err := iss.New()\nif err != nil {\n  // handle error\n}\n\nposition, err := client.GetPosition()\nif err != nil {\n  // handle error\n}\n\nfmt.Println(position)\n// Output: {10.5489 1.3942}\n\n```\n\n## Retrieving ISS coordinates using functions\n\nThe ```iss``` package provides a high level functions for retrieving ISS coordinates.\n\n```go\nlat, long, err := iss.GetPosition()\nif err != nil {\n  // handle error\n}\nfmt.Println(lat, long)\n// Output: -8.0037 14.7139\n\n```\n\n```go\nlat, long, err := iss.GetPositionAsStrings()\nif err != nil {\n  // handle error\n}\nfmt.Println(lat, long)\n// Output: -11.6732 17.4279\n\n```\n\n## A complete example program\n\nYou can see an example program which retrieves the ISS coordinates in the [examples/demo](examples/demo/main.go) folder.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fqba73%2Fiss","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fqba73%2Fiss","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fqba73%2Fiss/lists"}