Klasyfikatory regionów
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Klasyfikator regionu określa format i lokalizację obiektu. Klasyfikator może być 2-wymiarowym prostokątem na obrazie, wierszem tekstu w dokumencie, czasem trwania w filmie itp. Aby zdefiniować region, wybierz klasyfikator regionu, który pasuje do typu treści, których chcesz użyć. Jeśli na przykład Twoje treści to tekst, prawdopodobnie użyjesz klasyfikatora regionu txt lub line. Przykład klasyfikatora regionów znajdziesz w artykule Zarządzanie komentarzami i odpowiedziami.
Poniżej znajdziesz listę klasyfikatorów regionów dostępnych w interfejsie Google Drive API:
rectProstokąt na obrazie dwuwymiarowym.
| Właściwość |
Opis |
Typ |
x |
Pozycja na osi X. W przypadku obrazów domyślną jednostką są piksele, a w przypadku plików PDF – procenty. |
Liczba zmiennoprzecinkowa |
y |
Pozycja na osi Y. W przypadku obrazów domyślną jednostką są piksele, a w przypadku plików PDF – procenty. |
Liczba zmiennoprzecinkowa |
w |
Długość na osi X, domyślne jednostki to piksele w przypadku obrazów i procenty w przypadku plików PDF. |
Liczba zmiennoprzecinkowa |
h |
Długość na osi Y, domyślne jednostki to piksele w przypadku obrazów i procenty w przypadku plików PDF. |
Liczba zmiennoprzecinkowa |
mw |
Pełna szerokość dokumentu w momencie dodania komentarza. Użyj tego, aby wartości x i w były bez jednostek, ponieważ mogą działać jak wartość procentowa. |
Liczba zmiennoprzecinkowa |
mh |
Pełna wysokość dokumentu w momencie dodania komentarza. Cel znajdziesz w sekcji mw powyżej. |
Liczba zmiennoprzecinkowa |
r |
Stopnie obrotu dokumentu. Jeśli na przykład obraz jest obrócony o 90 stopni w prawo, prostokąt w punkcie 0,0 będzie wyświetlany w prawym górnym rogu obrazu. Musi to być jedna z wartości: 0, 90, 180, 270. |
Liczba zmiennoprzecinkowa |
pageNumer strony w pliku PDF, TIFF lub innym dokumencie zawierającym strony. Użyj tej opcji w przypadku dokumentów z elementami przypominającymi strony (np. arkusza kalkulacyjnego, slajdu lub warstwy).
| Właściwość |
Opis |
Typ |
p |
Numer strony (indeksowany od 0). |
Liczba całkowita |
mp |
Liczba stron w tym dokumencie. |
Liczba całkowita |
timeOkres czasu w filmie lub innym dokumencie z wymiarem czasu.
| Właściwość |
Opis |
Typ |
t |
Czas rozpoczęcia. |
hh:MM:ss.frac sformatowany ciąg znaków czasu (gdzie M = minuty, m = milisekundy; godziny i minuty są opcjonalne); |
d |
Czas trwania zakresu czasu. |
hh:MM:ss:mmm sformatowany ciąg znaków czasu (gdzie M = minuty, m = milisekundy) |
md |
Pełny czas trwania dokumentu. |
hh:MM:ss:mmm sformatowany ciąg znaków czasu (gdzie M = minuty, m = milisekundy) |
txtZakres tekstu w dokumencie.
| Właściwość |
Opis |
Typ |
o |
Opóźnienie rozpoczęcia (przesunięcie znaku od początku pliku). |
Liczba całkowita |
l |
Długość zakresu tekstu. |
Liczba całkowita |
ml |
Długość dokumentu w znakach. |
Liczba całkowita |
lineokreślony wiersz w pliku tekstowym lub w dowolnym pliku zawierającym wiersze;
| Właściwość |
Opis |
Typ |
n |
Numer wiersza. |
Liczba całkowita |
l |
Długość zakresu wierszy. |
Liczba całkowita |
ml |
Maksymalna liczba wierszy w pliku. |
Liczba całkowita |
matrixLokalizacja w strukturze przypominającej macierz. Służy do definiowania wierszy i kolumn w dokumentach arkusza kalkulacyjnego lub innych dokumentach, które mają strukturę wierszy i kolumn.
| Właściwość |
Opis |
Typ |
c |
Numer kolumny. |
Liczba całkowita |
r |
Numer wiersza. |
Liczba całkowita |
w |
Liczba kolumn. |
Liczba całkowita |
h |
Liczba wierszy. |
Liczba całkowita |
mw |
Maksymalna szerokość. |
Liczba całkowita |
mh |
Maksymalna wysokość. |
Liczba całkowita |
O ile nie stwierdzono inaczej, treść tej strony jest objęta licencją Creative Commons – uznanie autorstwa 4.0, a fragmenty kodu są dostępne na licencji Apache 2.0. Szczegółowe informacje na ten temat zawierają zasady dotyczące witryny Google Developers. Java jest zastrzeżonym znakiem towarowym firmy Oracle i jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2025-08-29 UTC.
[null,null,["Ostatnia aktualizacja: 2025-08-29 UTC."],[],[],null,["# Region classifiers\n\nA region classifier specifies the format and location for an object. A\nclassifier might be a 2-dimensional rectangle for an image, a line of text in a\ndocument, a time duration in a video, and so on. To define a region, select the\nregion classifier that matches the type of content you're trying to use. For\nexample, if your content is text, you're likely going to use either the `txt`\nor `line` region classifier. To see an example of a region classifier, see\n[Manage comments and\nreplies](https://developers.google.com/workspace/drive/api/guides/manage-comments#define).\n\nThe following is a list of the region classifiers included with the\nGoogle Drive API:\n\n`rect`\n\n: A rectangle in a 2-dimensional image.\n\n | Property | Description | Type |\n |----------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------|\n | `x` | Position on the x axis, units default to pixels for images and percent for PDFs. | Double |\n | `y` | Position on the y axis, units default to pixels for images and percent for PDFs. | Double |\n | `w` | Length on the x axis, units default to pixels for images and percent for PDFs. | Double |\n | `h` | Length on the y axis, units default to pixels for images and percent for PDFs. | Double |\n | `mw` | The full width of the document when the comment was made. Use this to make `x` and `w` unitless since they can act like a percentage. | Double |\n | `mh` | The full height of the document when the comment was made. See `mw` above for purpose. | Double |\n | `r` | The degrees of rotation of the document. For example, if an image is rotated 90 degrees clockwise then a rectangle at 0,0 displays in the top right of the image. Should be one of 0, 90, 180, 270. | Double |\n\n`page`\n\n: A page number in a PDF, TIFF, or other document with pages. Use this for documents with page-like elements (such as a spreadsheet, slide, or layer).\n\n | Property | Description | Type |\n |----------|---------------------------------------|---------|\n | `p` | The page number (0-indexed). | Integer |\n | `mp` | The number of pages in this document. | Integer |\n\n`time`\n\n: A duration of time in a video or other document with a time dimension.\n\n | Property | Description | Type |\n |----------|-----------------------------------------|-------------------------------------------------------------------------------------------------------|\n | `t` | The start time. | `hh:MM:ss.frac` formatted time string (where M = minutes, m = millis; hours and minutes are optional) |\n | `d` | The duration of the time range. | `hh:MM:ss:mmm` formatted time string (where M = minutes, m = millis) |\n | `md` | The full-time duration of the document. | `hh:MM:ss:mmm` formatted time string (where M = minutes, m = millis) |\n\n`txt`\n\n: A range of text in a document.\n\n | Property | Description | Type |\n |----------|-------------------------------------------------------------|---------|\n | `o` | Start offset (character offset from the start of the file). | Integer |\n | `l` | The length of the text range. | Integer |\n | `ml` | The length of this document in characters. | Integer |\n\n`line`\n\n: A specific line in a text file or any files with lines in it.\n\n | Property | Description | Type |\n |----------|------------------------------------------|---------|\n | `n` | Line number. | Integer |\n | `l` | The length of the line range. | Integer |\n | `ml` | The maximum number of lines in the file. | Integer |\n\n`matrix`\n\n: A location in a matrix-like structure. Used to define rows and columns in spreadsheet documents, or any other documents that have a row or column structure.\n\n | Property | Description | Type |\n |----------|------------------------|---------|\n | `c` | The column number. | Integer |\n | `r` | The row number. | Integer |\n | `w` | The number of columns. | Integer |\n | `h` | The number of rows. | Integer |\n | `mw` | The maximum width. | Integer |\n | `mh` | The maximum height. | Integer |"]]
