Face Detection Tutorial Issues

There are a few problems with the cloud vision face tutorial:

Setup

• canvas in optionalDependencies: This is a required dependency.
• “Put it all together”: This section does not have any description and does not have copy-pasteable code I would expect in an “All together” section.
• node faceDetection face.png:

Running

After the setup, run: node faceDetection face.png

You’ll get the error:

ERROR: { Error: ENOENT: no such file or directory, open 'face.png' errno: -2, code: 'ENOENT', syscall: 'open', path: 'face.png' }
{ Error: ENOENT: no such file or directory, open 'face.png' errno: -2, code: 'ENOENT', syscall: 'open', path: 'face.png' }
^C

What you really need is: node faceDetection.js resources/face.png

ERROR: { Error: 7 PERMISSION_DENIED: Cloud Vision API has not been used in project cloud-devshell-dev before or it is disabled. Enable it by visiting https://console.developers.googl
e.com/apis/api/vision.googleapis.com/overview?project=cloud-devshell-dev then retry. If you enabled this API recently, wait a few minutes for the action to propagate to our systems a
nd retry.

Fixing permissions

I tried to enable the Vision API in the Cloud Shell, first trying to find the API:

gcloud services list

ERROR: (gcloud.services.list) PERMISSION_DENIED: Not allowed to get project settings for project cloud-devshell-dev

I’m not sure if I could enable the API without knowing the id. Maybe I needed to create a new project rather than cloud-devshell-dev.

Guessing at the API id:

gcloud services enable vision.googleapis

User does not have permission to access service [vision.googleapis:enable] (or it may not exist): The caller does not have permission.

At this point I gave up. It would be ideal if you could just “Open in Cloud Shell”, npm i, and npm run detect.

I first found this tutorial on GitHub. The process of switching between cloud.google.com, GitHub tutorial README, GitHub main README, and Cloud Shell is very confusing.

[JustinBeckwith]

Thanks @grant! Handling this over to the @googleapis/ml-apis folks to take a look at 😃

[grant]

@dizcology Looks pretty good, but we still need a description for “Put it all together”. https://cloud.google.com/vision/docs/face-tutorial#put_it_all_together

We can’t just have unexplained code snippets.

Something like… To call our Vision API, create a main method which will...

Please re-open until that feedback is incorporated.