mirror of https://codeberg.org/andyscott/OpenWeather-gRPC-API.git synced 2024-09-15 22:38:07 -04:00

Microservice using gRPC to provide weather and geolocation data

geolocation geolocation-api go golang grpc grpc-go grpc-server microservice OpenWeatherMap weather weather-api

Find a file

Andrew Scott f4eaf5e1fb Improved error handling and responses for rpc failures		2022-09-01 22:47:37 -04:00
info	Updated UML diagram	2022-08-06 19:07:23 -04:00
proto	Improved error handling and responses for rpc failures	2022-09-01 22:47:37 -04:00
server	Improved error handling and responses for rpc failures	2022-09-01 22:47:37 -04:00
test-client	Units, City, and Zip lookups ok, need to handle unspecified location	2022-09-01 20:33:02 -04:00
.gitignore	Update .gitignore	2022-07-26 01:04:53 -04:00
go.mod	Update modules	2022-09-01 02:18:14 -04:00
go.sum	Update modules	2022-09-01 02:18:14 -04:00
LICENSE	Create LICENSE	2022-07-25 19:53:56 +02:00
README.md	Updated README	2022-08-31 22:55:59 -04:00

README.md

OpenWeather-gRPC-API

A microservice that accepts remote procedure calls to fetch weather data.

The service uses protocol buffers to define a gRPC API that fetches current and extended weather data.

Weather and geolocation data is obtained from OpenWeatherMap.org. At minimum, an API key that can access the the Current weather, Daily Forecast 16 Days, and Geocoding APIs is required.

Starting the Server

Before starting the server a file named .env must be be added to the root directory of the project, or the directory from which you'll execute the binary file, with the following fields:

API_KEY=xxxxxxxxxxxxxxxx
PORT=xxxxx

If you don't want to compile the code or can't use one of the binary releases you can run the server with the command go run server/*.go from the root of the project.

Sending Requests

Basic Workflow

Generate some server-side code and the code for your preferred language from the files in the proto directory with the protocol compiler protoc
- Note that the protoc-gen-go and protoc-gen-go-grpc plugins must be installed to generate the server-side code
Import your newly generated code into your project (Leave the servers code in the proto directory)
Use the imported code to allow your client to connect with the server
Use the imported code within your own functions to make requests

Generating code from the .proto files

Run protoc from the root of the project. The below example shows how one might generate Go code.

protoc -Iproto --go_opt=module=codeberg.org/andcscott/OpenWeatherMap-gRPC-API \
--go_out=. --go-grpc_opt=module=codeberg.org/andcscott/OpenWeatherMap-gRPC-API \
--go-grpc_out=. proto/*.proto

Importing the code

Import the code into your project. Example in Go:

import pb "codeberg.org/andcscott/OpenWeatherMap-gRPC-API/proto"

Using the imported code to connect to the server

First, enable your client to connect to the server. Example in Go:

conn, err := grpc.Dial("localhost:5000", grpc.WithTransportCredentials(insecure.NewCredentials()))
if err != nil {
	log.Fatalln(err)
}
defer conn.Close()

c := pb.NewWeatherServiceClient(conn)

See the test-client for more details.

Using the imported code to make requests

In this case, we're requesting the current weather for Corvallis, OR.

func doCurrent(c pb.WeatherServiceClient) {
	res, err := c.Current(context.Background(), &pb.RequestCurrent{
		City: "Corvallis",
	})
	if err != nil {
		log.Fatalln(err)
	}
	log.Println(res.Payload)
}