Class: Gcloud::Vision::Image::Context

Inherits:
Object
  • Object
show all
Defined in:
lib/gcloud/vision/image.rb

Overview

# Image::Context

Represents an image context.

Examples:

require "gcloud"

gcloud = Gcloud.new
vision = gcloud.vision

image = vision.image "path/to/landmark.jpg"
image.context.area.min = { longitude: -122.0862462,
                           latitude: 37.4220041 }
image.context.area.max = { longitude: -122.0762462,
                           latitude: 37.4320041 }

Defined Under Namespace

Classes: Area

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize ⇒ Context

Returns a new instance of Context.



459
460
461
462
 
# File 'lib/gcloud/vision/image.rb', line 459

def initialize
  @area = Area.new
  @languages = []
end

Instance Attribute Details

#area ⇒ Area (readonly)

Returns a lat/long rectangle that specifies the location of the image.

Returns:

  • (Area) —

    The lat/long pairs for ‘latLongRect`.



453
454
455
 
# File 'lib/gcloud/vision/image.rb', line 453

def area
  @area
end

#languages ⇒ Array<String>

A list of [ISO 639-1 language codes](en.wikipedia.org/wiki/List_of_ISO_639-1_codes) to use for text (OCR) detection. In most cases, an empty value will yield the best results as it will allow text detection to automatically detect the text language. For languages based on the latin alphabet a hint is not needed. In rare cases, when the language of the text in the image is known in advance, setting this hint will help get better results (although it will hurt a great deal if the hint is wrong).

Returns:

  • (Array<String>) —

    the current value of languages



450
451
452
 
# File 'lib/gcloud/vision/image.rb', line 450

def languages
  @languages
end

Instance Method Details

#empty? ⇒ Boolean

Returns ‘true` if either `min` or `max` are not populated.

Returns:

  • (Boolean) 


469
470
471
 
# File 'lib/gcloud/vision/image.rb', line 469

def empty?
  area.empty? && languages.empty?
end

#to_gapi ⇒ Object 



475
476
477
478
479
480
481
 
# File 'lib/gcloud/vision/image.rb', line 475

def to_gapi
  return nil if empty?
  gapi = Google::Apis::VisionV1::ImageContext.new
  gapi.lat_long_rect = area.to_gapi unless area.empty?
  gapi.language_hints = languages unless languages.empty?
  gapi
end