books_finder 4.4.0 books_finder: ^4.4.0 copied to clipboard
A library to help on the search for books on google books api
books_finder
A library to help on the search for books on the Google Books Api.
Usage #
First of all, import the library:
import 'package:books_finder/books_finder.dart';
Querying books #
To query books, just call the function queryBooks
:
final List<Book> books = await queryBooks(
'twilight',
queryType: QueryType.intitle,
maxResults: 3,
printType: PrintType.books,
orderBy: OrderBy.relevance,
);
You can change a few parameters to make your query more specific:
Parameter | Description | Nullable |
---|---|---|
queryType | Keywords to search in particular fields | Yes |
maxResults | Set the max amount of results | No |
startIndex | for pagination | No |
langRestrict | Retrict the query to a specific language | Yes |
orderBy | Order the query by newest or relevance | Yes |
printType | Filter by books, magazines or both | Yes |
reschemeImageLinks | Rescheme image urls from http to https |
No |
Books #
If you already have a Book
object, you can call book.info
to get all the book infos:
final info = book.info;
Parameter | Description |
---|---|
title (String ) |
Title of the book |
subtitle (String ) |
The subtile of the book |
authors (List<String> ) |
All the authors names |
publisher (String ) |
The publisher name |
publishedDate (DateTime ) |
The date it was published |
rawPublishedDate (String ) |
The date it was published in raw format |
description (String ) |
Description of the book |
pageCount (int ) |
The amount of pages |
categories (List<String> ) |
The categories the book is in |
averageRating (double ) |
The average rating of the book |
ratingsCount (int ) |
The amount of people that rated it |
maturityRating (String ) |
The maturity rating |
contentVersion (String ) |
The version of the content |
industryIdentifier (List<IndustryIdentifier> ) |
The identifiers of the book (isbn) |
imageLinks (List<Map<String, Uri>> ) |
The links with the avaiable image resources |
language (String ) |
The language code of the book |
Acknowledgements #
- @JimTim for industry identifiers and tests
- @Moomink for fixing
startIndex
- @niklasenberg for
BookInfo.subtitle
andQueryType
Issues and feedback #
Please file issues, bugs, or feature requests in our issue tracker.
To contribute a change to this plugin open a pull request.