# Location

## Fields & Relationships  

The table below provides a comprehensive overview of all fields and relationships for the **Location** object in **Maica**. Please refer to the table below for detailed information.

{% embed url="<https://docs.google.com/spreadsheets/d/1asABKRaw8i7tShsR4XTTe9U7axdM_d4WocXONNQtOQo/edit?usp=sharing>" %}
Location Schema
{% endembed %}

{% hint style="success" %}
Click [here](https://docs.google.com/spreadsheets/d/1asABKRaw8i7tShsR4XTTe9U7axdM_d4WocXONNQtOQo/edit?usp=sharing) to view and download the complete Location Schema.
{% endhint %}

## Automation

## Flows&#x20;

The list below outlines the **Flows** applied to the **Location Object** in **Maica**.

Please refer to the list below for more detailed information on each **Flow**.&#x20;

### Location Geocoding

This flow is designed to geocode a location's address upon creation or update of the location record.

| Flow Detail |                                   |
| ----------- | --------------------------------- |
| Flow Label  | Maica - Location Geocoding        |
| API Name    | `maica__Maica_Location_Geocoding` |
| Type        | `Autolaunched Flow`               |

#### Flow Summary

This flow geocodes the address of a location and updates the location record with the latitude and longitude by:

* Triggering on the creation or update of a location record.
* Geocoding the address fields using an Apex action.
* Checking for errors in the geocoding process.
* Updating the location record with the geocoded latitude and longitude if no errors occur.

<details>

<summary>Flow Description </summary>

1. **Start (Record-Triggered Flow)**:
   * The flow is triggered upon the creation or update of a location record.
   * The flow runs asynchronously after the record is saved.
   * Proceeds to geocode the address.
2. **Geocode the Address (Apex Action)**:
   * Calls the `GeocodeAddressInvocableProc` Apex action to geocode the address fields.
   * Passes the address fields and the record ID as input parameters.
   * Proceeds to the decision step to check for errors.
3. **Error? (Decision)**:
   * Checks if there was an error during the geocoding process by evaluating the `errorMessage` from the `Geocode_the_Address` action.
   * **No**: If no error, proceeds to update the location.
   * **Yes**: If an error occurred, the flow ends without updating the location.
4. **Update Location (Record Update)**:
   * Updates the location record with the latitude and longitude values obtained from the geocoding process.
   * Ends the flow.

</details>

## Trigger Handlers

The list below outlines the **Trigger Handlers** applied to the **Location Object** in **Maica**.

Please refer to the list below for more detailed information on each **Trigger Handler**.&#x20;

### Location Geocoding

This trigger is designed to manage the geocoding of locations in Maica.

| Detail     |                        |
| ---------- | ---------------------- |
| Load Order | 1                      |
| Label      | `LocationGeocode_MDTM` |

<details>

<summary>Execution, Logic &#x26; Outcome </summary>

**Execution of Trigger Logic**:

The trigger logic defined in the `LocationGeocode_MDTM` class is executed when the trigger conditions are met. The class contains the code that manages the geocoding process for locations.

* **Trigger Conditions**:
  * When a new location (`maica__Location__c`) is created.
  * When an existing location is updated.
  * Any specific field changes that are monitored by the trigger (defined in the handler class).

#### Logic Explanation

1. **Initialisation**:
   * When a location record is created or updated, the trigger is initialised. The `LocationGeocode_MDTM` metadata type configuration is loaded, ensuring that the trigger is active (`Active__c` is `true`) and has the correct load order (`Load_Order__c` is `1.0`).
2. **Trigger Execution**:
   * Upon initialisation, the trigger executes the logic defined in the `LocationGeocode_MDTM` class.
   * The class methods perform the following steps:
     * **Validation**: The location address data is validated to ensure it is complete and accurate.
     * **Geocoding**: The validated address data is converted into geographical coordinates using geocoding services.
     * **Update**: The location record is updated with the newly obtained geographical coordinates.

**Trigger Outcome**:

Once executed, the trigger ensures that each location is geocoded correctly, based on the logic defined in the handler class. This helps maintain accurate geographical data for locations.

</details>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://knowledge.maica.com.au/maica-knowledge-base/maica-administration-guide/data/data-objects/location.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.