Class ImageAnnotatorClient (3.4.4)

3.15.0 (latest) 3.14.0 3.13.0 3.12.1 3.11.0 3.10.2 3.9.0 3.8.1 3.7.4 3.6.0 3.5.0 3.4.5 3.3.1 3.2.0 3.1.4 3.0.0 2.8.0 2.7.3 2.6.3 2.5.0 2.4.4 2.3.2 2.2.0 2.1.0 2.0.0 1.0.2 0.42.0 0.41.0 0.40.0 0.39.0 0.38.1

ImageAnnotatorClient(*, credentials: typing.Optional[google.auth.credentials.Credentials] = None, transport: typing.Optional[typing.Union[str, google.cloud.vision_v1.services.image_annotator.transports.base.ImageAnnotatorTransport]] = None, client_options: typing.Optional[typing.Union[google.api_core.client_options.ClientOptions, dict]] = None, client_info: google.api_core.gapic_v1.client_info.ClientInfo = <google.api_core.gapic_v1.client_info.ClientInfo object>)

Layanan yang menjalankan tugas deteksi Google Cloud Vision API pada gambar klien, seperti deteksi wajah, tempat terkenal, logo, label, dan teks. Layanan ImageAnnotator menampilkan entity yang terdeteksi dari gambar.

Properti

{i>transport<i}

Menampilkan transport yang digunakan oleh instance klien.

Menampilkan
Jenis	Deskripsi
ImageAnnotatorTransport	Transportasi yang digunakan oleh instance klien.

Metode

ImageAnnotatorClient

ImageAnnotatorClient(*, credentials: typing.Optional[google.auth.credentials.Credentials] = None, transport: typing.Optional[typing.Union[str, google.cloud.vision_v1.services.image_annotator.transports.base.ImageAnnotatorTransport]] = None, client_options: typing.Optional[typing.Union[google.api_core.client_options.ClientOptions, dict]] = None, client_info: google.api_core.gapic_v1.client_info.ClientInfo = <google.api_core.gapic_v1.client_info.ClientInfo object>)

Membuat instance klien anotasi gambar.

Parameter
Nama	Deskripsi
credentials	Optional[google.auth.credentials.Credentials] Kredensial otorisasi yang akan dilampirkan ke permintaan. Kredensial ini mengidentifikasi aplikasi ke layanan; jika tidak ada yang ditentukan, klien akan mencoba memastikan kredensial dari lingkungan.
transport	Union[str, ImageAnnotatorTransport] Transportasi yang akan digunakan. Jika disetel ke None, transportasi akan dipilih secara otomatis.
client_options	Optional[Union[google.api_core.client_options.ClientOptions, dict]] Opsi kustom untuk klien. Tindakan ini tidak akan berlaku jika instance transport diberikan. (1) Properti api_endpoint dapat digunakan untuk mengganti endpoint default yang disediakan oleh klien. Variabel lingkungan GOOGLE_API_USE_MTLS_ENDPOINT juga dapat digunakan untuk mengganti endpoint: "always" (selalu menggunakan endpoint mTLS default), "never" (selalu menggunakan endpoint reguler default), dan "auto" (beralih secara otomatis ke endpoint mTLS default jika ada sertifikat klien, ini adalah nilai default). Namun, properti api_endpoint akan diprioritaskan jika diberikan. (2) Jika variabel lingkungan GOOGLE_API_USE_CLIENT_CERTIFICATE adalah "true", properti client_cert_source dapat digunakan untuk memberikan sertifikat klien untuk transportasi TLS bersama. Jika tidak diberikan, sertifikat klien SSL default akan digunakan jika ada. Jika GOOGLE_API_USE_CLIENT_CERTIFICATE adalah "false" atau tidak disetel, tidak ada sertifikat klien yang akan digunakan.
client_info	google.api_core.gapic_v1.client_info.ClientInfo Info klien yang digunakan untuk mengirim string agen pengguna bersama dengan permintaan API. Jika None, info default akan digunakan. Umumnya, Anda hanya perlu menyetel ini jika Anda mengembangkan library klien Anda sendiri.

Pengecualian
Jenis	Deskripsi
google.auth.exceptions.MutualTLSChannelError	Jika pembuatan transport TLS bersama gagal karena alasan apa pun.

__exit__

__exit__(type, value, traceback)

Melepaskan resource transportasi yang mendasarinya.

Peringatan: HANYA gunakan sebagai pengelola konteks jika transport TIDAK dibagikan dengan klien lain. Keluar dari blok with akan MENUTUP transport dan dapat menyebabkan error di klien lain!

batch_annotate_files

batch_annotate_files(
    request: typing.Optional[
        typing.Union[
            google.cloud.vision_v1.types.image_annotator.BatchAnnotateFilesRequest, dict
        ]
    ] = None,
    *,
    requests: typing.Optional[
        typing.MutableSequence[
            google.cloud.vision_v1.types.image_annotator.AnnotateFileRequest
        ]
    ] = None,
    retry: typing.Union[
        google.api_core.retry.Retry, google.api_core.gapic_v1.method._MethodDefault
    ] = _MethodDefault._DEFAULT_VALUE,
    timeout: typing.Union[float, object] = _MethodDefault._DEFAULT_VALUE,
    metadata: typing.Sequence[typing.Tuple[str, str]] = ()
) -> google.cloud.vision_v1.types.image_annotator.BatchAnnotateFilesResponse

Layanan yang menjalankan deteksi dan anotasi gambar untuk batch file. Sekarang hanya "application/pdf", "image/tiff", dan "image/gif" yang didukung. Layanan ini akan mengekstrak maksimal 5 (pelanggan dapat menentukan 5 dalam AnnotateFileRequest.pages) frame (gif) atau halaman (pdf atau tiff) dari setiap file yang disediakan dan melakukan deteksi serta anotasi untuk setiap gambar yang diekstrak.

# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.cloud import vision_v1

def sample_batch_annotate_files():
    # Create a client
    client = vision_v1.ImageAnnotatorClient()

    # Initialize request argument(s)
    request = vision_v1.BatchAnnotateFilesRequest(
    )

    # Make the request
    response = client.batch_annotate_files(request=request)

    # Handle the response
    print(response)

Parameter
Nama	Deskripsi
request	Union[google.cloud.vision_v1.types.BatchAnnotateFilesRequest, dict] Objek permintaan. Daftar permintaan untuk memberi anotasi file menggunakan BatchAnnotateFiles API.
requests	MutableSequence[google.cloud.vision_v1.types.AnnotateFileRequest] Wajib. Daftar permintaan anotasi file. Saat ini kami hanya mendukung satu AnnotateFileRequest di BatchAnnotateFilesRequest. Ini sesuai dengan kolom requests pada instance request; jika request diberikan, ini tidak boleh ditetapkan.
retry	google.api_core.retry.Retry Penetapan error yang harus dicoba lagi, jika ada.
timeout	float Waktu tunggu untuk permintaan ini.
metadata	Sequence[Tuple[str, str]] String yang harus dikirim bersama permintaan sebagai metadata.

Menampilkan
Jenis	Deskripsi
google.cloud.vision_v1.types.BatchAnnotateFilesResponse	Daftar respons anotasi file.

batch_annotate_images

batch_annotate_images(
    request: typing.Optional[
        typing.Union[
            google.cloud.vision_v1.types.image_annotator.BatchAnnotateImagesRequest,
            dict,
        ]
    ] = None,
    *,
    requests: typing.Optional[
        typing.MutableSequence[
            google.cloud.vision_v1.types.image_annotator.AnnotateImageRequest
        ]
    ] = None,
    retry: typing.Union[
        google.api_core.retry.Retry, google.api_core.gapic_v1.method._MethodDefault
    ] = _MethodDefault._DEFAULT_VALUE,
    timeout: typing.Union[float, object] = _MethodDefault._DEFAULT_VALUE,
    metadata: typing.Sequence[typing.Tuple[str, str]] = ()
) -> google.cloud.vision_v1.types.image_annotator.BatchAnnotateImagesResponse

Menjalankan deteksi dan anotasi gambar untuk sekumpulan gambar.

# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.cloud import vision_v1

def sample_batch_annotate_images():
    # Create a client
    client = vision_v1.ImageAnnotatorClient()

    # Initialize request argument(s)
    request = vision_v1.BatchAnnotateImagesRequest(
    )

    # Make the request
    response = client.batch_annotate_images(request=request)

    # Handle the response
    print(response)

Parameter
Nama	Deskripsi
request	Union[google.cloud.vision_v1.types.BatchAnnotateImagesRequest, dict] Objek permintaan. Beberapa permintaan anotasi gambar dikelompokkan menjadi satu panggilan layanan.
requests	MutableSequence[google.cloud.vision_v1.types.AnnotateImageRequest] Wajib. Permintaan anotasi gambar individual untuk batch ini. Ini sesuai dengan kolom requests pada instance request; jika request diberikan, ini tidak boleh ditetapkan.
retry	google.api_core.retry.Retry Penetapan error yang harus dicoba lagi, jika ada.
timeout	float Waktu tunggu untuk permintaan ini.
metadata	Sequence[Tuple[str, str]] String yang harus dikirim bersama permintaan sebagai metadata.

Menampilkan
Jenis	Deskripsi
google.cloud.vision_v1.types.BatchAnnotateImagesResponse	Respons terhadap permintaan anotasi gambar batch.

common_billing_account_path

common_billing_account_path(billing_account: str) -> str

Menampilkan string billing_account yang sepenuhnya memenuhi syarat.

common_folder_path

common_folder_path(folder: str) -> str

Menampilkan string folder yang sepenuhnya memenuhi syarat.

common_location_path

common_location_path(project: str, location: str) -> str

Menampilkan string lokasi yang sepenuhnya memenuhi syarat.

common_organization_path

common_organization_path(organization: str) -> str

Menampilkan string organisasi yang sepenuhnya memenuhi syarat.

common_project_path

common_project_path(project: str) -> str

Menampilkan string project yang sepenuhnya memenuhi syarat.

from_service_account_file

from_service_account_file(filename: str, *args, **kwargs)

Membuat instance klien ini menggunakan file kredensial yang disediakan.

Parameter
Nama	Deskripsi
filename	str Jalur ke file json kunci pribadi akun layanan.

Menampilkan
Jenis	Deskripsi
ImageAnnotatorClient	Klien yang dibuat.

from_service_account_info

from_service_account_info(info: dict, *args, **kwargs)

Membuat instance klien ini menggunakan info kredensial yang diberikan.

Parameter
Nama	Deskripsi
info	dict Info kunci pribadi akun layanan.

Menampilkan
Jenis	Deskripsi
ImageAnnotatorClient	Klien yang dibuat.

from_service_account_json

from_service_account_json(filename: str, *args, **kwargs)

Membuat instance klien ini menggunakan file kredensial yang disediakan.

Parameter
Nama	Deskripsi
filename	str Jalur ke file json kunci pribadi akun layanan.

Menampilkan
Jenis	Deskripsi
ImageAnnotatorClient	Klien yang dibuat.

get_mtls_endpoint_and_cert_source

get_mtls_endpoint_and_cert_source(
    client_options: typing.Optional[
        google.api_core.client_options.ClientOptions
    ] = None,
)

Menampilkan endpoint API dan sumber sertifikat klien untuk TLS bersama.

Sumber sertifikat klien ditentukan dalam urutan berikut: (1) Jika variabel lingkungan GOOGLE_API_USE_CLIENT_CERTIFICATE bukan "true", sumber sertifikat klien adalah None. (2) jika client_options.client_cert_source diberikan, gunakan yang diberikan; jika sumber sertifikat klien default ada, gunakan yang default; jika tidak, sumber sertifikat klien adalah None.

Endpoint API ditentukan dalam urutan berikut: (1) jika client_options.api_endpoint diberikan, gunakan yang diberikan. (2) jika variabel lingkungan GOOGLE_API_USE_CLIENT_CERTIFICATE adalah "always", gunakan endpoint mTLS default; jika variabel lingkungan adalah "never", gunakan endpoint API default; jika tidak, jika sumber sertifikat klien ada, gunakan endpoint mTLS default, jika tidak, gunakan endpoint API default.

Detail selengkapnya dapat ditemukan di https://google.aip.dev/auth/4114.

Parameter
Nama	Deskripsi
client_options	google.api_core.client_options.ClientOptions Opsi kustom untuk klien. Hanya properti api_endpoint dan client_cert_source yang dapat digunakan dalam metode ini.

Pengecualian
Jenis	Deskripsi
google.auth.exceptions.MutualTLSChannelError	Jika terjadi error.

Menampilkan
Jenis	Deskripsi
Tuple[str, Callable[[], Tuple[bytes, bytes]]]	menampilkan endpoint API dan sumber sertifikat klien yang akan digunakan.

parse_common_billing_account_path

parse_common_billing_account_path(path: str) -> typing.Dict[str, str]

Mengurai jalur billing_account ke dalam segmen komponennya.

parse_common_folder_path

parse_common_folder_path(path: str) -> typing.Dict[str, str]

Mengurai jalur folder ke dalam segmen komponennya.

parse_common_location_path

parse_common_location_path(path: str) -> typing.Dict[str, str]

Mengurai jalur lokasi ke dalam segmen komponennya.

parse_common_organization_path

parse_common_organization_path(path: str) -> typing.Dict[str, str]

Mengurai jalur organisasi ke dalam segmen komponennya.

parse_common_project_path

parse_common_project_path(path: str) -> typing.Dict[str, str]

Mengurai jalur project ke dalam segmen komponennya.

parse_product_path

parse_product_path(path: str) -> typing.Dict[str, str]

Mengurai jalur produk ke dalam segmen komponennya.

parse_product_set_path

parse_product_set_path(path: str) -> typing.Dict[str, str]

Mengurai jalur product_set ke dalam segmen komponennya.

product_path

product_path(project: str, location: str, product: str) -> str

Menampilkan string produk yang sepenuhnya memenuhi syarat.

product_set_path

product_set_path(project: str, location: str, product_set: str) -> str

Menampilkan string product_set yang sepenuhnya memenuhi syarat.