{"id":2854,"date":"2017-02-28T08:41:20","date_gmt":"2017-02-28T16:41:20","guid":{"rendered":"https:\/\/www.couchbase.com\/blog\/?p=2854"},"modified":"2025-06-13T21:40:21","modified_gmt":"2025-06-14T04:40:21","slug":"graphql-server-node-couchbase-ottoman-spatial-view","status":"publish","type":"post","link":"https:\/\/www.couchbase.com\/blog\/graphql-server-node-couchbase-ottoman-spatial-view\/","title":{"rendered":"Graphql server with node and couchbase, ottoman and spatial view"},"content":{"rendered":"

Jose Navarro<\/span><\/a> is a full stack developer at FAMOCO in Brussels, Belgium. He has been working for the last 3 years as a web developer<\/a> with Node.js, Java, AngularJS, and ReactJS, and has deep interest in web development and mobile technologies.<\/em><\/p>\n

We are going to develop a Graphql<\/a><\/u>\u00a0server in nodejs with express. Graphql is a query language for APIs, it was developed by facebook and it was released in 2015. It is designed to build client applications by providing an intuitive and flexible syntax and system for describing their data requirements and interactions. One of the biggest differences with REST APIs is that you only have one entry endpoint for all the resources, instead of one endpoint for every resource; And with graphql you specify what attributes you want for each request, instead of receive whatever the REST API service returns, so we can be sure that we have all the data that we need and reduce the size of our requests.<\/p>\n

Facebook has been using it for a few years in their mobile app, for example in the iOS app, and old version of their mobile app still works without problem because the graphql did not change, because it is one endpoint with the same schema, this probably would not be possible with REST APIs because when you release a new version of you API, your endpoint probably is going to change, so the clients needs to adapt to the new endpoint and data. Also Github<\/a><\/u>\u00a0open their graphql server, so the users can query their services using graphql, instead of the REST APIs services..<\/p>\n

With the server we are going to query and create Places<\/strong>. To store the data we are going to use couchbase and we are going to use Spatial views to query the Places by its geographical location. I wrote a previous post<\/a><\/u>\u00a0about node and couchbase, so I will skip the configuration of the db that I wrote in the previous post.<\/p>\n

Requirements<\/h2>\n

You need to have installed in your computer:<\/p>\n

– nodejs<\/p>\n

– couchbase server<\/p>\n

You can find the code in the github repo<\/a><\/u>.<\/p>\n

Spatial View<\/h2>\n

First of all we need to create the spatial view. We go to the admin page, in my case https:\/\/localhost:8091\/<\/a><\/u>\u00a0and log in with my user and password. Then click on Data Buckets<\/strong>\u00a0and create a bucket, i called it graphql<\/em>. After that we click on View<\/strong>, then we click on Create Development Spatial View<\/strong>, and we type the values.<\/p>\n

\"Create<\/p>\n

I used place_by_location<\/em>\u00a0in both Design Document Name<\/strong>\u00a0and View Name<\/strong>. Now click on edit<\/strong>, and add the following code<\/p>\n


\nfunction\u00a0(doc)\u00a0{<\/code><\/p>\n

if\u00a0(doc._type ===\u00a0‘Place’\u00a0&&\u00a0doc.location)\u00a0{<\/p>\n

emit([{<\/p>\n

“type”:\u00a0“Point”,<\/p>\n

“coordinates”:\u00a0[doc.location.lon,\u00a0doc.location.lat]<\/p>\n

}],\u00a0doc);<\/p>\n

}<\/p>\n

}
\nand click on Save<\/strong>.<\/p>\n

Here you can also test the view with the documents on the bucket.<\/p>\n

Place Model<\/h2>\n

For our places, we are going to store the name of the place and a description as string.<\/p>\n

Since we want to use the SpatialView<\/a> that Couchbase<\/a> provides, we are going to store the location of the place in an object called *location* where we are going to store the latitude and longitude.<\/p>\n

Also we will set by default the created date when we add the place.<\/p>\n


\nconst\u00a0PlaceModel\u00a0=\u00a0ottoman.model('Place',\u00a0{<\/code><\/p>\n

name:\u00a0‘string’,<\/p>\n

description:\u00a0‘string’,<\/p>\n

location:\u00a0{<\/p>\n

lat:\u00a0‘number’,<\/p>\n

lon:\u00a0‘number’<\/p>\n

},<\/p>\n

created:\u00a0{<\/p>\n

type:\u00a0‘Date’,<\/p>\n

default:\u00a0Date.now<\/p>\n

}<\/p>\n

});
\nFor the spatial query, we are going to define a function that will perform a spatial query. For that we are going to create a spatial query using the couchbase package.<\/p>\n


\nconst\u00a0queryByLocation =\u00a0(bbox =\u00a0[0,\u00a00,\u00a00,\u00a00],\u00a0next)\u00a0=>\u00a0{<\/code><\/p>\n

const\u00a0query =\u00a0couchbase.SpatialQuery.from(‘dev_place_by_location’,\u00a0‘place_by_location’).bbox(bbox);<\/p>\n

bucket.query(query,\u00a0next);<\/p>\n

}
\nIn the *from* function, we have to provide the *design document name* and the *view name*. Then in the bbox(bounding box), we need to provide the array of 4 floats **[ min Longitude , min Latitude , max Longitude , max Latitude ]**.<\/p>\n

The last step is to perform the query in the bucket.<\/p>\n

Graphql Server<\/h2>\n

We are going to use an express server and the package express-graphql.<\/p>\n

We import the schema of our graphql server that we are going to define later.<\/p>\n


\nconst\u00a0express =\u00a0require('express');<\/code><\/p>\n

const\u00a0graphqlHTTP =\u00a0require(‘express-graphql’);<\/p>\n

const\u00a0PORT =\u00a0process.env.PORT ||\u00a05000;<\/p>\n

const\u00a0schema =\u00a0require(‘.\/schemas’);<\/p>\n

const\u00a0app =\u00a0express();<\/p>\n

app.use(‘\/graphql’,\u00a0graphqlHTTP({<\/p>\n

schema:\u00a0schema,<\/p>\n

graphiql:\u00a0true,<\/p>\n

}));<\/p>\n

\/\/ start server<\/p>\n

const\u00a0server =\u00a0app.listen(PORT,\u00a0()\u00a0=>\u00a0{<\/p>\n

console.log(`Server started at ${ server.address().port }`);<\/p>\n

});
\nIn the graphql server, we are going to use the route *\/graphql*. And we are going to set some option, like graphiql, that will provide us a graphic interface to execute queries.<\/p>\n

The last step is start our express server.<\/p>\n

Graphql Schemas<\/h2>\n

Graphql queries and mutations rely on the schemas that we define. So we have to create a schema for our Place object.<\/p>\n

First we are going to define a Schema for Location<\/strong>.<\/p>\n


\nconst\u00a0{<\/code><\/p>\n

GraphQLObjectType,<\/p>\n

GraphQLFloat,<\/p>\n

GraphQLNonNull,<\/p>\n

}\u00a0=\u00a0require(‘graphql’);<\/p>\n

const\u00a0LocationSchema\u00a0=\u00a0new\u00a0GraphQLObjectType({<\/p>\n

name:\u00a0‘Location’,<\/p>\n

description:\u00a0‘Geographical location’,<\/p>\n

fields:\u00a0{<\/p>\n

lat:\u00a0{<\/p>\n

type:\u00a0new\u00a0GraphQLNonNull(GraphQLFloat),<\/p>\n

description:\u00a0‘Latitude’,<\/p>\n

},<\/p>\n

lon:\u00a0{<\/p>\n

type:\u00a0new\u00a0GraphQLNonNull(GraphQLFloat),<\/p>\n

description:\u00a0‘Longitude’,<\/p>\n

},<\/p>\n

}<\/p>\n

});<\/p>\n

module.exports =\u00a0LocationSchema;<\/p>\n

We need to import the types from graphql<\/em>\u00a0package. In our schema we can define a name and a description, this fields are useful to document our queries, so the user can understand what that field means.<\/p>\n

Then we have to define fields<\/em>, where we are going to specify the fields inside our schema, in this case, we have defined lat<\/em>\u00a0and lon<\/em>. In every field we have to specify the type, in this case these fields are float values, and they are required, so we use GraphQLNonNull<\/em>\u00a0 and \u00a0the type GraphQLFloat<\/em>. We add a description so we can now what they mean.<\/p>\n

Now we are going to define the schema Place<\/strong>.<\/p>\n

Here we are going to import the types from graphql<\/em>\u00a0and the schema Location<\/em>\u00a0that we have defined.<\/p>\n


\nconst\u00a0{<\/code><\/p>\n

GraphQLObjectType,<\/p>\n

GraphQLString,<\/p>\n

GraphQLNonNull,<\/p>\n

}\u00a0=\u00a0require(‘graphql’);<\/p>\n

const\u00a0LocationSchema\u00a0=\u00a0require(‘.\/location’);<\/p>\n

const\u00a0PlaceSchema\u00a0=\u00a0new\u00a0GraphQLObjectType({<\/p>\n

name:\u00a0‘Place’,<\/p>\n

description:\u00a0‘Place description’,<\/p>\n

fields:\u00a0{<\/p>\n

id:\u00a0{<\/p>\n

type:\u00a0GraphQLString,<\/p>\n

resolve(place)\u00a0{<\/p>\n

return\u00a0place._id;<\/p>\n

}<\/p>\n

},<\/p>\n

name:\u00a0{<\/p>\n

type:\u00a0GraphQLString,<\/p>\n

},<\/p>\n

description:{<\/p>\n

type:\u00a0GraphQLString,<\/p>\n

},<\/p>\n

location:\u00a0{<\/p>\n

type:\u00a0LocationSchema,<\/p>\n

},<\/p>\n

created:\u00a0{<\/p>\n

type:\u00a0GraphQLString,<\/p>\n

}<\/p>\n

}<\/p>\n

});<\/p>\n

module.exports =\u00a0PlaceSchema;<\/p>\n

We are matching the fields from the model, so we do not have to provide the resolve function. Only for the field id<\/em>, because couchbase return the value in the field _id<\/strong>.<\/p>\n

Graphql Query<\/h2>\n

Query is the way that we retrieve data for the server.<\/p>\n

The query object is also a schema, like the previous ones. In this case the fields are the queries we allow the user to perform. We are going to define 3 types of query.<\/p>\n

allPlaces<\/h3>\n

In this query we are going to query for all the places in the database, and we are going to order them by the created field, so we return first the newest places.<\/p>\n

Like we are going to return an array of Places, we assign to type<\/strong>\u00a0the type GraphQLList<\/em>\u00a0and we provide the Place schema<\/em><\/p>\n


\n...<\/code><\/p>\n

const\u00a0PlaceSchema\u00a0=\u00a0require(‘.\/place’);<\/p>\n

const\u00a0Place\u00a0=\u00a0require(‘..\/models\/place’);<\/p>\n

…<\/p>\n

allPlaces:\u00a0{<\/p>\n

type:\u00a0new\u00a0GraphQLList(PlaceSchema),<\/p>\n

description:\u00a0‘Query for all places’,<\/p>\n

resolve(root,\u00a0args)\u00a0{<\/p>\n

return\u00a0new\u00a0Promise((resolve,\u00a0reject)\u00a0=>\u00a0{<\/p>\n

Place.find({},\u00a0{<\/p>\n

sort:\u00a0{<\/p>\n

created:\u00a0-1<\/p>\n

},<\/p>\n

},\u00a0(err,\u00a0places)\u00a0=>\u00a0{<\/p>\n

if\u00a0(err)\u00a0{<\/p>\n

reject(err);<\/p>\n

}<\/p>\n

resolve(places);<\/p>\n

})<\/p>\n

});<\/p>\n

}<\/p>\n

}<\/p>\n

We also add a description, this field is optional.<\/p>\n

The last parameter is a function, that is the resolve function, that will specify how we are going to retrieve the data for our database. As our calls to the database are asynchronous, we are going to return a promise, that is going to use the Place model that we defined with ottoman. With the model we use find to query for documents, and we pass as the first parameter an empty object, because we want to query all the documents; The second parameter is the options of our query, in this case we are going to order by the field created<\/em>\u00a0in descending order. Finally we provide the callback function that will resolve the promise with the values, or reject it in case of an error.<\/p>\n

Places<\/h3>\n

In this query we are going to query using the Spatial view, so we have to pass the bbox points in the parameter of the query.<\/p>\n


\n...<\/code><\/p>\n

const\u00a0queryByLocation =\u00a0require(‘..\/models\/place’).queryByLocation;<\/p>\n

…<\/p>\n

Places:\u00a0{<\/p>\n

type:\u00a0new\u00a0GraphQLList(PlaceSchema),<\/p>\n

description:\u00a0‘Query for all places inside the boundary box’,<\/p>\n

args:\u00a0{<\/p>\n

minLon:\u00a0{<\/p>\n

type:\u00a0new\u00a0GraphQLNonNull(GraphQLFloat),<\/p>\n

description:\u00a0‘Min Longitude of the boundary box’,<\/p>\n

},<\/p>\n

maxLon:\u00a0{<\/p>\n

type:\u00a0new\u00a0GraphQLNonNull(GraphQLFloat),<\/p>\n

description:\u00a0‘Max Longitude of the boundary box’,<\/p>\n

},<\/p>\n

minLat:\u00a0{<\/p>\n

type:\u00a0new\u00a0GraphQLNonNull(GraphQLFloat),<\/p>\n

description:\u00a0‘Min Latitude of the boundary box’,<\/p>\n

},<\/p>\n

maxLat:\u00a0{<\/p>\n

type:\u00a0new\u00a0GraphQLNonNull(GraphQLFloat),<\/p>\n

description:\u00a0‘Max Latitude of the boundary box’,<\/p>\n

},<\/p>\n

},<\/p>\n

resolve(root,\u00a0args)\u00a0{<\/p>\n

\/\/ bbox = [ min Longitude , min Latitude , max Longitude , max Latitude ]<\/p>\n

const\u00a0bbox =\u00a0[<\/p>\n

args.minLon,<\/p>\n

args.minLat,<\/p>\n

args.maxLon,<\/p>\n

args.maxLat,<\/p>\n

];<\/p>\n

return\u00a0new\u00a0Promise((resolve,\u00a0reject)\u00a0=>\u00a0{<\/p>\n

queryByLocation(bbox,\u00a0(err,\u00a0places)\u00a0=>\u00a0{<\/p>\n

if\u00a0(err)\u00a0{<\/p>\n

reject(err);<\/p>\n

}<\/p>\n

resolve(places.map((place)\u00a0=>\u00a0place.value));<\/p>\n

})<\/p>\n

});<\/p>\n

}<\/p>\n

}<\/p>\n

First we import the function that we defined to perform the spatial query.<\/p>\n

As the previous query, we define the type as an array of places, and add a description.<\/p>\n

In this query, we need some parameter, so we define the args, that refers to the parameter; Each value inside args<\/em>\u00a0correspond with the parameters, in this case we define 4, minLon, maxLon, minLat, maxLat<\/strong>\u00a0and for all of them we are going to define the type as required and floats.<\/p>\n

In this case, the resolve function is also a promise. First we build the bbox array to pass the function queryByLocation<\/em>. In case of an error, we will reject the promise with an error; In case of success, we need to map the object from the db, because the spatial view returns the geopoint and value, where we are returning the full document, it will change if we define a different spatial view.<\/p>\n

Place<\/h3>\n

The last query that we are going to define, is the one to query for one place by its id.<\/p>\n


\nPlace:\u00a0{<\/code><\/p>\n

type:\u00a0PlaceSchema,<\/p>\n

description:\u00a0‘Query for a place by the place id’,<\/p>\n

args:\u00a0{<\/p>\n

id:\u00a0{<\/p>\n

type:\u00a0new\u00a0GraphQLNonNull(GraphQLString),<\/p>\n

description:\u00a0‘Place id’,<\/p>\n

}<\/p>\n

},<\/p>\n

resolve(root,\u00a0args)\u00a0{<\/p>\n

return\u00a0new\u00a0Promise((resolve,\u00a0reject)\u00a0=>\u00a0{<\/p>\n

Place.getById(args.id,\u00a0(err,\u00a0place)\u00a0=>\u00a0{<\/p>\n

if\u00a0(err)\u00a0{<\/p>\n

reject(err);<\/p>\n

}<\/p>\n

resolve(place);<\/p>\n

});<\/p>\n

});<\/p>\n

}
\nIn this case, the type is the Place schema<\/em>, in the args, we only need to define the id<\/strong>\u00a0and we set it to string and required.<\/p>\n

The resolve function, again is a promise, in this case we are going to use the function queryById<\/em>\u00a0from the model, and we pass the id<\/em>\u00a0value from the args object.<\/p>\n

Graphql Mutation<\/h2>\n

With mutations we can modify the data in our server. As the query, mutations object are schemas. So we have to define the same fields as the previous schemas.<\/p>\n

When we perform the mutation query we provide the values between parenthesis, and like the queries, we provide the values we want to retrieve of the modified object.<\/p>\n

Here we are going to perform the creation, update and delete of Places.<\/p>\n

createPlace<\/h3>\n

In this mutation we are going to create a new place.<\/p>\n

In the type of the schema we are going to define it as Place Schema<\/em>, because we are going to return the created Place.<\/p>\n


\ncreatePlace:\u00a0{<\/code><\/p>\n

type:\u00a0PlaceSchema,<\/p>\n

description:\u00a0‘Create a place’,<\/p>\n

args:\u00a0{<\/p>\n

name:\u00a0{<\/p>\n

type:\u00a0new\u00a0GraphQLNonNull(GraphQLString),<\/p>\n

description:\u00a0‘Name of the place’,<\/p>\n

},<\/p>\n

description:\u00a0{<\/p>\n

type:\u00a0new\u00a0GraphQLNonNull(GraphQLString),<\/p>\n

description:\u00a0‘Description of the place’,<\/p>\n

},<\/p>\n

latitude:\u00a0{<\/p>\n

type:\u00a0new\u00a0GraphQLNonNull(GraphQLFloat),<\/p>\n

description:\u00a0‘Latitude of the place’,<\/p>\n

},<\/p>\n

longitude:\u00a0{<\/p>\n

type:\u00a0new\u00a0GraphQLNonNull(GraphQLFloat),<\/p>\n

description:\u00a0‘Longitude of the place’,<\/p>\n

}<\/p>\n

},<\/p>\n

resolve(source,\u00a0args)\u00a0{<\/p>\n

return\u00a0new\u00a0Promise((resolve,\u00a0reject)\u00a0=>\u00a0{<\/p>\n

const\u00a0place =\u00a0new\u00a0Place({<\/p>\n

name:\u00a0args.name,<\/p>\n

description:\u00a0args.description,<\/p>\n

location:\u00a0{<\/p>\n

lat:\u00a0args.latitude,<\/p>\n

lon:\u00a0args.longitude,<\/p>\n

},<\/p>\n

});<\/p>\n

place.save((err)\u00a0=>\u00a0{<\/p>\n

if\u00a0(err)\u00a0{<\/p>\n

reject(err);<\/p>\n

}<\/p>\n

resolve(place);<\/p>\n

})<\/p>\n

});<\/p>\n

}<\/p>\n

}
\nLike the queries, we define the args with the values that we require to create a new Place. In this case we require name and description as strings, and latitude and longitude as floats, all fields are going to be required.<\/p>\n

In the resolve function, we are going to return a promise. Inside the promise we are going to create the place with the values of the query inside args<\/em>. Then we are going to perform save<\/em>\u00a0on the place object. Finally, in case of an error saving the place, we are going to reject the promise with the error, or we are going to resolve the promise with the place data.<\/p>\n

updatePlace<\/h3>\n

As in the createPlace<\/em>\u00a0mutation, the updatePlace<\/em>\u00a0mutation is similar, the differences are that in this case, all the values in the args are not required, and the id field is a required string; And in the resolve function, first we are going to look for the object by the id<\/em>, then we check the fields provided by the user and update the place, and finally we save it, and return the new object<\/p>\n


\nupdatePlace:\u00a0{<\/code><\/p>\n

type:\u00a0PlaceSchema,<\/p>\n

description:\u00a0‘Update a place’,<\/p>\n

args:\u00a0{<\/p>\n

id:\u00a0{<\/p>\n

type:\u00a0new\u00a0GraphQLNonNull(GraphQLString),<\/p>\n

description:\u00a0‘Id of the place’,<\/p>\n

},<\/p>\n

name:\u00a0{<\/p>\n

type:\u00a0GraphQLString,<\/p>\n

description:\u00a0‘Name of the place’,<\/p>\n

},<\/p>\n

description:\u00a0{<\/p>\n

type:\u00a0GraphQLString,<\/p>\n

description:\u00a0‘Description of the place’,<\/p>\n

},<\/p>\n

latitude:\u00a0{<\/p>\n

type:\u00a0GraphQLFloat,<\/p>\n

description:\u00a0‘Latitude of the place’,<\/p>\n

},<\/p>\n

longitude:\u00a0{<\/p>\n

type:\u00a0GraphQLFloat,<\/p>\n

description:\u00a0‘Longitude of the place’,<\/p>\n

}<\/p>\n

},<\/p>\n

resolve(source,\u00a0args)\u00a0{<\/p>\n

return\u00a0new\u00a0Promise((resolve,\u00a0reject)\u00a0=>\u00a0{<\/p>\n

Place.getById(args.id,\u00a0(err,\u00a0place)\u00a0=>\u00a0{<\/p>\n

if\u00a0(err)\u00a0{<\/p>\n

reject(err);<\/p>\n

}\u00a0else\u00a0{<\/p>\n

if\u00a0(args.name)\u00a0{<\/p>\n

place.name =\u00a0args.name;<\/p>\n

}<\/p>\n

if\u00a0(args.description)\u00a0{<\/p>\n

place.name =\u00a0args.name;<\/p>\n

}<\/p>\n

if\u00a0(args.latitude)\u00a0{<\/p>\n

place.location.lat =\u00a0args.latitude;<\/p>\n

}<\/p>\n

if\u00a0(args.longitude)\u00a0{<\/p>\n

place.location.lon =\u00a0args.longitude;<\/p>\n

}<\/p>\n

place.save((err)\u00a0=>\u00a0{<\/p>\n

if\u00a0(err)\u00a0{<\/p>\n

reject(err);<\/p>\n

}<\/p>\n

resolve(place);<\/p>\n

});<\/p>\n

}<\/p>\n

})<\/p>\n

});<\/p>\n

}<\/p>\n

}<\/p>\n

deletePlace<\/h3>\n

The last mutation is the delete, here we define a type of Place Schema<\/em>, because we are going to return the object we delete.<\/p>\n

In the args, we only need to define the id<\/em>\u00a0of the place to delete.<\/p>\n

In the resolve function, we are going to return a Promise that is going to search for the place by id, and the perform the remove. We will reject the promise in case the place is not found or if there is an error while removing it; Or we are going to resolve the promise with the place data in case we remove it successfully.<\/p>\n


\ndeletePlace:\u00a0{<\/code><\/p>\n

type:\u00a0PlaceSchema,<\/p>\n

description:\u00a0‘Delete a place’,<\/p>\n

args:\u00a0{<\/p>\n

id:\u00a0{<\/p>\n

type:\u00a0new\u00a0GraphQLNonNull(GraphQLString),<\/p>\n

description:\u00a0‘Id of the place’,<\/p>\n

},<\/p>\n

},<\/p>\n

resolve(source,\u00a0args)\u00a0{<\/p>\n

return\u00a0new\u00a0Promise((resolve,\u00a0reject)\u00a0=>\u00a0{<\/p>\n

Place.getById(args.id,\u00a0(err,\u00a0place)\u00a0=>\u00a0{<\/p>\n

if\u00a0(err)\u00a0{<\/p>\n

reject(err);<\/p>\n

}\u00a0else\u00a0{<\/p>\n

place.remove((err)\u00a0=>\u00a0{<\/p>\n

if\u00a0(err)\u00a0{<\/p>\n

reject(err);<\/p>\n

}<\/p>\n

resolve(place);<\/p>\n

});<\/p>\n

}<\/p>\n

})<\/p>\n

});<\/p>\n

}<\/p>\n

}<\/p>\n

Test<\/h2>\n

To test our app, we are going to use Graphiql, that we allow in our server, for that we have to visit https:\/\/localhost:5000\/graphql<\/p>\n

\"graphiql\"<\/p>\n

In this page, we can perform the queries and mutations that we defined previously.<\/p>\n

Create<\/h3>\n


\nmutation {<\/code><\/p>\n

createPlace(<\/p>\n

name:\u00a0“testplace”<\/p>\n

description:\u00a0“testdescription”<\/p>\n

latitude:\u00a01.36<\/p>\n

longitude:\u00a018.36<\/p>\n

)\u00a0{<\/p>\n

id<\/p>\n

}<\/p>\n

}<\/p>\n

\"mutation<\/p>\n

Update<\/h3>\n


\nmutation {<\/code><\/p>\n

updatePlace(<\/p>\n

id:\u00a0“41133f98-18e8-4979-89e0-7af012b0e14f”<\/p>\n

name:\u00a0“updateplace”<\/p>\n

description:\u00a0“updatedescription”<\/p>\n

latitude:\u00a02.36<\/p>\n

longitude:\u00a015.96<\/p>\n

)\u00a0{<\/p>\n

id<\/p>\n

name<\/p>\n

description<\/p>\n

}<\/p>\n

}<\/p>\n

\"mutation<\/p>\n

Delete<\/h3>\n


\nmutation {<\/code><\/p>\n

deletePlace(id:\u00a0“41133f98-18e8-4979-89e0-7af012b0e14f”)\u00a0{<\/p>\n

id<\/p>\n

}<\/p>\n

}
\n\"mutation<\/p>\n

Query All<\/h3>\n


\nquery {<\/code><\/p>\n

allPlaces {<\/p>\n

id<\/p>\n

name<\/p>\n

location {<\/p>\n

lat<\/p>\n

lon<\/p>\n

}<\/p>\n

}<\/p>\n

}<\/p>\n

\"query<\/p>\n

Query by boundary box<\/h3>\n


\nquery {<\/code><\/p>\n

Places(<\/p>\n

minLon:\u00a03<\/p>\n

maxLon:\u00a05<\/p>\n

minLat:\u00a049<\/p>\n

maxLat:\u00a051<\/p>\n

)\u00a0{<\/p>\n

name<\/p>\n

location {<\/p>\n

lat<\/p>\n

lon<\/p>\n

}<\/p>\n

}<\/p>\n

}
\n\"query<\/p>\n

Query a place by id<\/h3>\n


\n```<\/code><\/p>\n

mutation {<\/p>\n

deletePlace(id:\u00a0“41133f98-18e8-4979-89e0-7af012b0e14f”)\u00a0{<\/p>\n

id<\/p>\n

}<\/p>\n

}<\/p>\n

“`
\n\"query<\/p>\n

Conclusion<\/h2>\n

Graphql is a good query language that allow us to query only for the information that we define, so we can avoid underfetching or overfetching, and we can be sure that we always have the data.<\/p>\n

In a Graphql server, the clients only use one single endpoint, so it hides the complexity and logics of the backend, so the server can connect to different backends, or use different databases, and if they change, the clients logic do not have to change because the endpoint is the same.<\/p>\n

Also we have seen how to perform geographical query in our data with couchbase.<\/p>\n

References<\/h2>\n