> Portal Navigation: > > - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version. > - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages). > - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`). > - Top-level index of all portals: https://dev.wix.com/docs/llms.txt > - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt # Method name: getLocation(_id: string) # Method package: wixBusinessToolsV2 # Method menu location: wixBusinessToolsV2 --> locations --> getLocation # Method Link: https://dev.wix.com/docs/velo/apis/wix-business-tools-v2/locations/get-location.md # Method Description: Retrieves a location. # Method Code Examples: *** Note: do not assume any prop names or enum values other than the ones in the example. ## Get a location (dashboard page code) ```javascript import { locations } from 'wix-business-tools.v2'; import { elevate } from 'wix-auth'; /* Sample _id value: '0a965e36-4071-4df0-905b-75458817430a' */ export async function myGetLocationFunction(_id) { try { const elevatedGetLocation = elevate(locations.getLocation); const myLocation = await elevatedGetLocation(_id); console.log('Here are the details of the location:', myLocation); return myLocation; } catch (error) { console.error(error); // Handle the error } } /* Promise resolves to: * { * "_id": "0a965e36-4071-4df0-905b-75458817430a", * "address": { * "streetAddress": { * "apt": "", * "name": "Calle Miguel Hidalgo", * "number": "15" * }, * "city": "La Reforma", * "postalCode": "22000" * }, * "archived": false, * "default": false, * "description": "Our brand new, budget store in the heart of Mexico City!", * "email": "store@example.com", * "phone": "+52 55 1234 5678", * "name": "Mexico Store", * "revision": "2", * "status": "ACTIVE", * "timeZone": "America/Mexico_City" * } */ ``` ## Get a location (export from backend code) ```javascript import { Permissions, webMethod } from 'wix-web-module'; import { locations } from 'wix-business-tools.v2'; import { elevate } from 'wix-auth'; /* Sample _id value: '0a965e36-4071-4df0-905b-75458817430a' */ export const myGetLocationFunction = webMethod(Permissions.Anyone, async (_id) => { try { const elevatedGetLocation = elevate(locations.getLocation); const myLocation = await elevatedGetLocation(_id); console.log('Here are the details of the location:', myLocation); return myLocation; } catch (error) { console.error(error); // Handle the error } }); /* Promise resolves to: * { * "_id": "0a965e36-4071-4df0-905b-75458817430a", * "address": { * "streetAddress": { * "apt": "", * "name": "Calle Miguel Hidalgo", * "number": "15" * }, * "city": "La Reforma", * "postalCode": "22000" * }, * "archived": false, * "default": false, * "description": "Our brand new, budget store in the heart of Mexico City!", * "email": "store@example.com", * "phone": "+52 55 1234 5678", * "name": "Mexico Store", * "revision": "2", * "status": "ACTIVE", * "timeZone": "America/Mexico_City" * } */ ``` ## Get a location's properties ```javascript /************************************** * Backend code - get-location.web.js * *************************************/ import { Permissions, webMethod } from 'wix-web-module'; import { locations } from 'wix-business-tools.v2'; import { elevate } from 'wix-auth'; export const getLocationById = webMethod(Permissions.Anyone, async (locationId) => { try { const elevatedGetLocation = elevate(locations.getLocation); const myLocation = await elevatedGetLocation(locationId); return myLocation; } catch (error) { console.error(error); throw new Error(error); } }); export const listLocations = webMethod(Permissions.Anyone, async () => { try { const elevatedListLocations = elevate(locations.listLocations); const results = await elevatedListLocations(); return results.locations; } catch (error) { console.error(error); throw new Error(error); } }); /************* * Page code * ************/ import { getLocationById, listLocations } from 'backend/get-location.web'; $w.onReady(async () => { await populateStoresDropdown(); $w('#getLocationBtn').onClick(async () => { const locationId = $w('#locationsDropdown').value; const myLocation = await getLocationById(locationId); console.log('Here are the details of the location:', myLocation); $w('#locationDetails').text = myLocation; }); }); async function populateStoresDropdown() { const locations = await listLocations(); const dropdownOptions = locations.map((location) => { return { label: location.name, value: location._id } }); $w('#locationsDropdown').options = dropdownOptions; } ``` ---