Before You Begin
This 15-minute tutorial shows you how to use location matches to check the accuracy of map results.
Background
You can view match results of the geographical locations in your map visualization. The Location Match dialog shows these types of matches:
- 100% confidence
- Multiple possible locations (ambiguous matches)
- Low confidence with matches in the map layer (partial matches)
- No location found in the map layer that matches your data point
You might want to:
- Correct spelling of cities, states, or countries in your data source.
- Add data such as county or province to resolve matches with multiple possible map locations.
- Add filters to the map visualization to increase the match quality.
- Create a custom map layer such as a postal code map layer that provides additional details about the data that isn't available in the default map layer.
Creating a custom map layer requires administrator privileges and an understanding of map layers.
In this tutorial, you create a map visualization, correct and remove data, and create a filter using the available data.
What Do You Need?
- Access to Oracle Analytics Cloud or Oracle Analytics Desktop
- Download the following files to your computer:
Create a Dataset
In this section, you review location matches in your map visualization of sales by cities in the United States.
- Sign in to Oracle Analytics.
- On the Home page, click Create, and then select Dataset.
- In Create Dataset, click Drop data file here or click to browse, select the
superstore_data.xlsx
file, and then click Open. - In Create Dataset From superstore_data.xlsx, click OK.
- Click Save
. In Save Dataset As, enter
superstore_data
, and then click OK.Description of the illustration superstore_dataset.png
Create a Map Visualization
In this section, you create a map visualization with sales from cities around the world.
- Click Create Workbook. Close the Auto Insights panel.
- From the Data panel, hold down the Ctrl key, select City and Sales, and then right-click Pick Visualization. Select Map
.
Description of the illustration city_sales_map.png - Click the visualization Menu
and select Location Matches.
Description of the illustration city_sales_matches.png Location Matches shows 219 ambiguous matches because the United States includes multiple cities with the same name.
- Click OK.
- From the Data panel, drag State to Category (Location) in the Grammar panel to add more detail to the map.
The map appears the same as the map visualization that just used City.
Description of the illustration city_state_map.png - Right-click the map visualization and select Location Matches.
The addition of State to the map layer resolved all but 5 of the location match issues.
Description of the illustration location_matches_state.png - Click Cancel.
Create a Filter
In this section, you use a filter in the visualization to narrow your map view to a specific area of interest, and possibly reduce the number of location mismatches.
- In the canvas, click Add Filter
. From superstore_data, select Region. From Region, select East, and then click outside of the selection dialog.
The map visualization changes to show the data points in the East region. However, a couple of data points appear in the mid-west.
Description of the illustration region_filter_map.png - Click the visualization Menu
and select Location Matches.
The region filter reduced the location match issues to four. If you added county to your dataset, the out of region location match issues might disappear. Because the City of Orange, New Jersey, and East Orange, New Jersey are in the same county, the location match issues probably won't totally disappear without a custom map layer of New England cities. A custom New England cities layer would also resolve the Darien and Fairfield, Connecticut location match issues.
Description of the illustration region_filter.png - Click Save. In Save Workbook, enter
Cities Location Matches
in Name, and then click Save. Click Go backto return to the Home page.
Create a Map Visualization with World Cities
In this section, you create a new workbook with a different data source.
- On the Home page, click Create, and then select Dataset.
- In Create Dataset, click Drop data file here or click to browse, select the
world_cities_data.xlsx
file, and then click Open. - In Create Dataset table from world_cities_data, click OK.
- Click Save
. In Save Dataset As, enter
world_cities_data
, and then click OK - Click Create Workbook. Close the Auto Insights panel.
- From the Data panel, hold down the Ctrl key, select City and Sales, and then right-click Pick Visualization. Select Map
.
Description of the illustration city_sales_world.png - Click the visualization Menu
and select Location Matches.
Location Matches can't find the small French village of Eze and Riccione, Italy on the default map.
Description of the illustration world_cities_loc_matches.png - From the Data panel, drag Country to Category (Location) in the Grammar panel to possibly improve matches.
Description of the illustration city_country_map.png - Click the visualization Menu
and select Location Matches.
With the addition of Country to the world cities map layer, the village of Eze has four matches and Riccione has 22 matches. The number of location match issues are reduced from 21 to 16.
Description of the illustration country_city_world.png - In Location Matches, click the check box in the Riccione row, and then click Remove to create a filter to remove the selected item. Click OK.
- Right-click the map view, and then click Location Matches.
Adding country removed some of the ambiguous matches, and Riccione no longer appears in Locations Matches. In your workbook, scroll through the dialog to review the location matches.
Description of the illustration riccione_removed.png
Correct Data Source Issues
In the Location Matches, under the Your Data column, the City of Caiyro is spelled incorrectly.
- In the workbook, click Save. In Save Workbook, enter
World Sales
in Name, and then click Save. - Open the
world_cities_data.xlsx
file. In the spreadsheet, use Ctrl + F, and then in Find What, enterCaiyro
. Close the Find dialog. - In the row with Caiyro, enter
Cairo
, click Save, and then close the file.
Update the Data in Your Workbook
In this section, you reload the updated data source and refresh the workbook.
- On the Home page, click Data in the search bar, enter
world_cities_data
, and then click Search. In world_cities_data, click Actions, and then select Reload Data.
- On the Home page, click Workbooks, enter
World Sales
, and then click Search. - In the World Sales workbook, click the Actions
, and then select Open.
- In the workbook, click Menu
, and then select Refresh Data.
- Click the visualization Menu
and select Location Matches.
- In Location Matches, scroll to Cairo to view the correction made in the dataset.
Description of the illustration cairo.png
Create a Pivot Table
In the Location Matches dialog, some data points had multiple matches. In this section, you create a pivot table that enables viewing all of your City sales data points.
- In the Data panel, hold down the Ctrl key, and select the following:
- Country
- City
- Sales
- Right-click, select Pick Visualization, and then select Pivot
.
- In the Grammar panel, drag City to Color, and then drag County to Rows.
You can scroll through the list in the pivot table to review the data.
Description of the illustration city_country_sales_pivot.png
Learn More
Review and Manage Location Matches in Oracle Analytics
F23705-05
May 2024
Learn how to review location matches for data in a map visualization in Oracle Analytics.
This software and related documentation are provided under a license agreement containing restrictions on use and disclosure and are protected by intellectual property laws. Except as expressly permitted in your license agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast, modify, license, transmit, distribute, exhibit, perform, publish, or display any part, in any form, or by any means. Reverse engineering, disassembly, or decompilation of this software, unless required by law for interoperability, is prohibited.
If this is software or related documentation that is delivered to the U.S. Government or anyone licensing it on behalf of the U.S. Government, then the following notice is applicable:
U.S. GOVERNMENT END USERS: Oracle programs (including any operating system, integrated software, any programs embedded, installed or activated on delivered hardware, and modifications of such programs) and Oracle computer documentation or other Oracle data delivered to or accessed by U.S. Government end users are "commercial computer software" or "commercial computer software documentation" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, the use, reproduction, duplication, release, display, disclosure, modification, preparation of derivative works, and/or adaptation of i) Oracle programs (including any operating system, integrated software, any programs embedded, installed or activated on delivered hardware, and modifications of such programs), ii) Oracle computer documentation and/or iii) other Oracle data, is subject to the rights and limitations specified in the license contained in the applicable contract. The terms governing the U.S. Government's use of Oracle cloud services are defined by the applicable contract for such services. No other rights are granted to the U.S. Government.
This software or hardware is developed for general use in a variety of information management applications. It is not developed or intended for use in any inherently dangerous applications, including applications that may create a risk of personal injury. If you use this software or hardware in dangerous applications, then you shall be responsible to take all appropriate fail-safe, backup, redundancy, and other measures to ensure its safe use. Oracle Corporation and its affiliates disclaim any liability for any damages caused by use of this software or hardware in dangerous applications.
Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners.
Intel and Intel Inside are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks are used under license and are trademarks or registered trademarks of SPARC International, Inc. AMD, Epyc, and the AMD logo are trademarks or registered trademarks of Advanced Micro Devices. UNIX is a registered trademark of The Open Group.
This software or hardware and documentation may provide access to or information about content, products, and services from third parties. Oracle Corporation and its affiliates are not responsible for and expressly disclaim all warranties of any kind with respect to third-party content, products, and services unless otherwise set forth in an applicable agreement between you and Oracle. Oracle Corporation and its affiliates will not be responsible for any loss, costs, or damages incurred due to your access to or use of third-party content, products, or services, except as set forth in an applicable agreement between you and Oracle.