Kolumna lokalizacji przechowuje lokalizację geograficzną z dokładnością do długości i szerokości geograficznej, a adres wyświetla w interfejsie jako tekst.

Za pomocą API możesz odczytywać i filtrować wartości kolumny lokalizacji, aktualizować je i czyścić.

Typ kolumny	Typ implementacji	Obsługiwane operacje
location	LocationValue	Odczyt: Tak Filtrowanie: Tak Aktualizacja: Tak Czyszczenie: Tak

---

Zapytania

Możesz wysyłać zapytania dotyczące kolumn lokalizacji za pomocą pola column_values obiektu items, korzystając z wbudowanego fragmentu dla typu LocationValue.

query {
  items(ids: [1234567890, 9876543210]) {
    name
    column_values {
      ... on LocationValue {
        id
        address
        city
        country
        country_short
        lat
        lng
        place_id
        street
        street_number
        text
        value
        updated_at
      }
    }
  }
}

const query = `
  query ($itemIds: [ID!]) {
    items(ids: $itemIds) {
      name
      column_values {
        ... on LocationValue {
          id
          address
          city
          country
          country_short
          lat
          lng
          place_id
          street
          street_number
          text
          value
          updated_at
        }
      }
    }
  }
`;

const variables = { itemIds: [1234567890, 9876543210] };

const response = await mondayApiClient.request(query, variables);

Pola

Możesz użyć poniższych pól, aby określić, jakie informacje zwróci implementacja LocationValue.

Pole	Opis
address String	Adres lokalizacji.
city String	Miasto, w którym znajduje się lokalizacja.
city_short String	Skrócona nazwa miasta, w którym znajduje się lokalizacja.
column Column!	Kolumna, do której należy wartość.
country String	Kraj, w którym znajduje się lokalizacja.
country_short String	Skrócona nazwa kraju, w którym znajduje się lokalizacja (np. "PE" dla Peru).
id ID!	Unikalny identyfikator kolumny.
lat Float	Szerokość geograficzna lokalizacji.
lng Float	Długość geograficzna lokalizacji.
place_id String	Unikalny identyfikator lokalizacji (Google Places).
street String	Ulica, przy której znajduje się lokalizacja.
street_number String	Numer budynku przy ulicy.
street_number_short String	Skrócony numer budynku przy ulicy.
street_short String	Skrócona nazwa ulicy.
text String	Wartość kolumny w postaci tekstu. Jeśli kolumna nie ma wartości, zwraca "".
type ColumnType!	Typ kolumny.
updated_at Date	Data ostatniej aktualizacji kolumny.
value JSON	Surowa wartość kolumny w formacie JSON.

Przykładowa odpowiedź

{
  "data": {
    "items": [
      {
        "name": "Office Location",
        "column_values": [
          {
            "id": "location",
            "address": "Giza Pyramid Complex",
            "city": null,
            "country": null,
            "country_short": null,
            "lat": 29.9773,
            "lng": 31.1325,
            "place_id": null,
            "street": null,
            "street_number": null,
            "text": "Giza Pyramid Complex",
            "value": "{\"lat\":\"29.9773\",\"lng\":\"31.1325\",\"address\":\"Giza Pyramid Complex\",\"changed_at\":\"2026-03-20T12:00:00.000Z\"}",
            "updated_at": "2026-03-20T12:00:00+00:00"
          }
        ]
      }
    ]
  }
}

---

Filtrowanie

Możesz filtrować elementy według wartości lokalizacji za pomocą obiektu items_page. Kolumna lokalizacji umożliwia filtrowanie według tekstu adresu oraz tego, czy wartość jest pusta.

Operator	Wartość porównawcza	Opis
contains_terms	Wartość tekstowa (np. "Tokyo")	Zwraca elementy, których adres lokalizacji zawiera podany tekst.
is_empty	[]	Zwraca elementy z pustą (nieustawioną) wartością lokalizacji.
is_not_empty	[]	Zwraca elementy, dla których ustawiono wartość lokalizacji.

Przykłady

Filtrowanie według tekstu adresu

Ten przykład zwraca wszystkie elementy z określonej tablicy, których adres lokalizacji zawiera tekst „Tokyo”.

query {
  boards(ids: 1234567890) {
    items_page(
      query_params: {
        rules: [
          {
            column_id: "location"
            compare_value: "Tokyo"
            operator: contains_terms
          }
        ]
      }
    ) {
      items {
        id
        name
        column_values {
          ... on LocationValue {
            address
            lat
            lng
          }
        }
      }
    }
  }
}

Filtrowanie według pustej lokalizacji

Ten przykład zwraca wszystkie elementy z określonej tablicy, które mają pustą wartość lokalizacji.

query {
  boards(ids: 1234567890) {
    items_page(
      query_params: {
        rules: [
          {
            column_id: "location"
            compare_value: []
            operator: is_empty
          }
        ]
      }
    ) {
      items {
        id
        name
      }
    }
  }
}

Filtrowanie według niepustej lokalizacji

Ten przykład zwraca wszystkie elementy z określonej tablicy, dla których ustawiono wartość lokalizacji.

query {
  boards(ids: 1234567890) {
    items_page(
      query_params: {
        rules: [
          {
            column_id: "location"
            compare_value: []
            operator: is_not_empty
          }
        ]
      }
    ) {
      items {
        id
        name
      }
    }
  }
}

---

Mutacje

Aktualizacja wartości

Możesz zaktualizować kolumnę lokalizacji za pomocą mutacji change_simple_column_value lub change_multiple_column_values. W zależności od wybranej mutacji możesz przesłać wartość jako zwykły ciąg tekstowy lub obiekt JSON.

change_simple_column_value

Prześlij szerokość i długość geograficzną oraz opcjonalny adres jako ciąg wartości oddzielonych spacjami w polu value. Format: "lat lng address".

mutation {
  change_simple_column_value(
    item_id: 9876543210
    board_id: 1234567890
    column_id: "location"
    value: "29.9772962 31.1324955 Giza Pyramid Complex"
  ) {
    id
  }
}

const query = `
  mutation ($boardId: ID!, $itemId: ID!, $columnId: String!, $value: String!) {
    change_simple_column_value(
      item_id: $itemId
      board_id: $boardId
      column_id: $columnId
      value: $value
    ) {
      id
    }
  }
`;

const variables = {
  boardId: "1234567890",
  itemId: "9876543210",
  columnId: "location",
  value: "29.9772962 31.1324955 Giza Pyramid Complex"
};

const response = await mondayApiClient.request(query, variables);

change_multiple_column_values

Prześlij pola lat, lng oraz opcjonalne pole address jako obiekt JSON w column_values.

mutation {
  change_multiple_column_values(
    item_id: 9876543210
    board_id: 1234567890
    column_values: "{\"location\": {\"lat\": \"29.9772962\", \"lng\": \"31.1324955\", \"address\": \"Giza Pyramid Complex\"}}"
  ) {
    id
  }
}

const query = `
  mutation ($boardId: ID!, $itemId: ID!, $columnValues: JSON!) {
    change_multiple_column_values(
      item_id: $itemId
      board_id: $boardId
      column_values: $columnValues
    ) {
      id
    }
  }
`;

const variables = {
  boardId: "1234567890",
  itemId: "9876543210",
  columnValues: JSON.stringify({
    location: {
      lat: "29.9772962",
      lng: "31.1324955",
      address: "Giza Pyramid Complex"
    }
  })
};

const response = await mondayApiClient.request(query, variables);

Ustawianie lokalizacji podczas tworzenia elementu

Możesz ustawić wartość lokalizacji podczas tworzenia elementu, przekazując wartość kolumny lokalizacji w argumencie column_values.

mutation {
  create_item(
    board_id: 1234567890
    item_name: "New office"
    column_values: "{\"location\": {\"lat\": \"40.7128\", \"lng\": \"-74.0060\", \"address\": \"New York, NY\"}}"
  ) {
    id
    name
  }
}

Czyszczenie wartości

Możesz wyczyścić kolumnę lokalizacji za pomocą mutacji change_multiple_column_values, przekazując null lub pusty obiekt w column_values.

mutation {
  change_multiple_column_values(
    item_id: 9876543210
    board_id: 1234567890
    column_values: "{\"location\": null}"
  ) {
    id
  }
}

---

Odczytywanie konfiguracji kolumny

Możesz wysłać zapytanie dotyczące ustawień kolumny lokalizacji za pomocą pola settings tej kolumny. Kolumny lokalizacji nie mają konfigurowalnych ustawień, więc settings zwraca pusty obiekt JSON.

query {
  boards(ids: 1234567890) {
    columns(ids: ["location"]) {
      id
      title
      settings
    }
  }
}

Przykładowa odpowiedź settings

{}

---

Pobieranie schematu typu kolumny

Możesz programowo pobrać schemat JSON ustawień kolumny lokalizacji za pomocą zapytania get_column_type_schema. Zwraca ono strukturę, reguły walidacji i dostępne właściwości konfiguracji kolumny.

query {
  get_column_type_schema(
    type: location
  )
}

{
  "data": {
    "get_column_type_schema": {
      "schema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "type": "object",
        "properties": {
          "settings": {
            "type": "object",
            "description": "Column specific settings",
            "properties": {},
            "additionalProperties": false
          }
        }
      }
    }
  }
}

Odpowiedź zawiera nazwy właściwości, ich typy, ograniczenia (takie jak maksymalna długość i dozwolone wartości) oraz opisy poszczególnych ustawień. Możesz użyć tych informacji do walidacji ustawień kolumny, dynamicznego generowania interfejsów użytkownika lub przekazywania kontekstu agentom AI. Dowiedz się więcej o formacie odpowiedzi schematu.