ObjectDetection
Stay organized with collections
Save and categorize content based on your preferences.
Entry point to get an ObjectDetector
for finding DetectedObject
s
in a supplied image.
An ObjectDetector
is created via
getClient(ObjectDetectorOptionsBase)
.
Example:
ObjectDetector objectDetector = ObjectDetection.getClient(options);
To perform object detection in an image, you first need to create an instance of
InputImage
from a Bitmap
,
ByteBuffer
, etc. See
InputImage
documentation for more details. For example, the code below creates an InputImage
from a Bitmap
.
InputImage image = InputImage.fromBitmap(bitmap, rotationDegrees);
Then the code below can detect objects in the supplied InputImage
.
Task<List<DetectedObject>> task = objectDetector.process(image);
task.addOnSuccessListener(...).addOnFailureListener(...);
Inherited Method Summary
From class java.lang.Object
Object
|
clone()
|
boolean |
|
void |
finalize()
|
final Class<?>
|
getClass()
|
int |
hashCode()
|
final void |
notify()
|
final void |
notifyAll()
|
String
|
toString()
|
final void |
wait(long arg0, int arg1)
|
final void |
wait(long arg0)
|
final void |
wait()
|
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2024-10-31 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2024-10-31 UTC."],[[["\u003cp\u003e\u003ccode\u003eObjectDetection\u003c/code\u003e is the entry point for object detection in images using ML Kit.\u003c/p\u003e\n"],["\u003cp\u003eYou create an \u003ccode\u003eObjectDetector\u003c/code\u003e instance using \u003ccode\u003eObjectDetection.getClient()\u003c/code\u003e with specified options.\u003c/p\u003e\n"],["\u003cp\u003eObject detection is performed by processing an \u003ccode\u003eInputImage\u003c/code\u003e with the \u003ccode\u003eObjectDetector\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eRemember to call \u003ccode\u003eObjectDetector.close()\u003c/code\u003e to release resources when the detector is no longer needed.\u003c/p\u003e\n"]]],[],null,["# ObjectDetection\n\npublic class **ObjectDetection** extends [Object](//developer.android.com/reference/java/lang/Object.html) \nEntry point to get an [ObjectDetector](/android/reference/com/google/mlkit/vision/objects/ObjectDetector)\nfor finding [DetectedObject](/android/reference/com/google/mlkit/vision/objects/DetectedObject)s\nin a supplied image.\n\nAn [ObjectDetector](/android/reference/com/google/mlkit/vision/objects/ObjectDetector)\nis created via [getClient(ObjectDetectorOptionsBase)](/android/reference/com/google/mlkit/vision/objects/ObjectDetection#getClient(com.google.mlkit.vision.objects.ObjectDetectorOptionsBase)).\n\nExample: \n\n ObjectDetector objectDetector = ObjectDetection.getClient(options); \n\nTo perform object detection in an image, you first need to create an instance of\n[InputImage](/android/reference/com/google/mlkit/vision/common/InputImage)\nfrom a [Bitmap](//developer.android.com/reference/android/graphics/Bitmap.html),\n[ByteBuffer](//developer.android.com/reference/java/nio/ByteBuffer.html), etc. See\n[InputImage](/android/reference/com/google/mlkit/vision/common/InputImage)\ndocumentation for more details. For example, the code below creates an [InputImage](/android/reference/com/google/mlkit/vision/common/InputImage)\nfrom a [Bitmap](//developer.android.com/reference/android/graphics/Bitmap.html). \n\n InputImage image = InputImage.fromBitmap(bitmap, rotationDegrees); \n\nThen the code below can detect objects in the supplied [InputImage](/android/reference/com/google/mlkit/vision/common/InputImage). \n\n Task\u003cList\u003cDetectedObject\u003e\u003e task = objectDetector.process(image);\n task.addOnSuccessListener(...).addOnFailureListener(...); \n\n### Public Method Summary\n\n|--------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| static [ObjectDetector](/android/reference/com/google/mlkit/vision/objects/ObjectDetector) | [getClient](/android/reference/com/google/mlkit/vision/objects/ObjectDetection#getClient(com.google.mlkit.vision.objects.ObjectDetectorOptionsBase))([ObjectDetectorOptionsBase](/android/reference/com/google/mlkit/vision/objects/ObjectDetectorOptionsBase) options) Gets a new instance of [ObjectDetector](/android/reference/com/google/mlkit/vision/objects/ObjectDetector) that can detect objects in a supplied image with the given options. |\n\n### Inherited Method Summary\n\nFrom class java.lang.Object \n\n|----------------------------------------------------------------------------|--------------------------------------------------------------------------------|\n| [Object](//developer.android.com/reference/java/lang/Object.html) | clone() |\n| boolean | equals([Object](//developer.android.com/reference/java/lang/Object.html) arg0) |\n| void | finalize() |\n| final [Class](//developer.android.com/reference/java/lang/Class.html)\\\u003c?\\\u003e | getClass() |\n| int | hashCode() |\n| final void | notify() |\n| final void | notifyAll() |\n| [String](//developer.android.com/reference/java/lang/String.html) | toString() |\n| final void | wait(long arg0, int arg1) |\n| final void | wait(long arg0) |\n| final void | wait() |\n\nPublic Methods\n--------------\n\n#### public static [ObjectDetector](/android/reference/com/google/mlkit/vision/objects/ObjectDetector)\n**getClient** ([ObjectDetectorOptionsBase](/android/reference/com/google/mlkit/vision/objects/ObjectDetectorOptionsBase) options)\n\nGets a new instance of [ObjectDetector](/android/reference/com/google/mlkit/vision/objects/ObjectDetector)\nthat can detect objects in a supplied image with the given options.\n\nTo release the resources associated with an [ObjectDetector](/android/reference/com/google/mlkit/vision/objects/ObjectDetector),\nyou need to ensure that [ObjectDetector.close()](/android/reference/com/google/mlkit/vision/objects/ObjectDetector#close())\nis called on the resulting [ObjectDetector](/android/reference/com/google/mlkit/vision/objects/ObjectDetector)\ninstance once it will no longer be used. \n\n##### Parameters\n\n| options | the options for the object detector. It should be one of the concrete options like [ObjectDetectorOptions](/android/reference/com/google/mlkit/vision/objects/defaults/ObjectDetectorOptions) or [CustomObjectDetectorOptions](/android/reference/com/google/mlkit/vision/objects/custom/CustomObjectDetectorOptions). |\n|---------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|"]]