Skip to content

Vision changes - #696

Merged
quartzmo merged 5 commits into
googleapis:visionfrom
blowmage:vision-changes
May 18, 2016
Merged

Vision changes#696
quartzmo merged 5 commits into
googleapis:visionfrom
blowmage:vision-changes

Conversation

@blowmage

Copy link
Copy Markdown
Contributor

Implement some requested changes to the existing Vision implementation. Including renaming Analysis to Annotation and adding support for default max results when giving a truthy value to #annotate.

require"gcloud"gcloud=Gcloud.newvision=gcloud.visionannotation=vision.annotate"path/to/faces.jpg",faces: true# As opposed to having to pass in the numeric value# annotation = vision.annotate "path/to/faces.jpg", faces: 10

Received feedback that analysis and analyses were not as preferred as
annotation and annotations. Rename class, update code examples and docs.
Add configuration for setting the default max results values.
Allow truthy values to #annotate to use the default max result values.
@blowmageblowmage added type: feature request ‘Nice-to-have’ improvement, new feature or different behavior or design. api: vision Issues related to the Cloud Vision API. labels May 18, 2016
@blowmageblowmage added this to the Vision milestone May 18, 2016
@googlebotgooglebot added the cla: yes This human has signed the Contributor License Agreement. label May 18, 2016
We want to encourage users to use boolean flags instead of setting max result
values in every method call. A custom max result value can be given, but should
be presented as a secondary option to using the boolean flag.
Update method signatures to prioritize boolean flags as default values.
@quartzmo

Copy link
Copy Markdown
Member

I think changing the syntax from faces: 10 to faces: true is a huge improvement in usability. It considerably lowers the friction to trying out the Vision service. For bulk (production) users, setting global configuration is also better. Win-win in my opinion.

Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

api: visionIssues related to the Cloud Vision API.cla: yesThis human has signed the Contributor License Agreement.type: feature request‘Nice-to-have’ improvement, new feature or different behavior or design.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants

@blowmage@quartzmo@googlebot