Generate Points From Business Listings (Business Analyst)

Available with Business Analyst license.

Summary

Creates a point feature layer from a business point location search.

Usage

  • Output Feature Class will exclude the Address field.

  • The following countries contain data required for a Business Listing search: USA, Canada.

  • To enable the Business Dataset parameter options, set the Data Source environment to Online.

  • Using the Include Only Exact Matches parameter with the Search Terms parameter will return restrictive results. For example, entering Johnson`s Supermarket in the Search Terms parameter with the Include Only Exact Matches parameter checked, the following will not be returned:

    • Johnson`s Market
    • Johnson`s Supermarket & Pharmacy
    • Johnson and Sons Supermarket & Pharmacy

  • The FilterValue option in the Filters parameter can be set by applying a minimum or maximum value only or by applying a range between the minimum and maximum values.

    • Min:Number—Filters businesses with variable values less than the number assigned, for example, min:100.
    • Max:Number—Filters businesses with variable values greater than the number assigned, for example, max:500.
    • Min:Number Max:Number—Filters businesses outside of the range of values assigned, for example, min:100 max:500.

Syntax

arcpy.ba.GeneratePointsFromBusinessListings(out_feature_class, {in_search_features}, {search_terms}, {exact_match}, {match_name_only}, {filters}, {max_count}, {business_dataset})
ParameterExplanationData Type
out_feature_class

The output feature class that will contain the returned businesses.

Feature Class
in_search_features
(Optional)

The area that will be used to search for businesses. Selected features supersede the feature class and will be used as the search area.

Feature Layer
search_terms
(Optional)

The terms that will be used to search for businesses. You can use terms such as business name or business type keywords. If this parameter is not set, all businesses from the Input Search Features parameter will be returned.

String
exact_match
(Optional)

Specifies whether only the text entered in the search_terms parameter will be returned from the search.

  • EXACT_MATCHOnly exact matches to the text entered in the search_terms parameter will be returned.
  • PARTIAL_MATCHPartial matches to the text entered in the search_terms parameter as well as exact matches will be returned. This is the default.
Boolean
match_name_only
(Optional)

Specifies whether the search will be limited to the business name only.

  • MATCH_NAME_ONLYOnly exact matches to the business name entered in the search_terms parameter will be returned.
  • MATCH_ALL_FIELDSPartial matches to the business name entered in the search_terms parameter as well as exact matches will be returned. This is the default.
Boolean
filters
[[filter_name, filter_value, include],...]
(Optional)

Specifies the filters that will be applied to the search_terms parameter.

  • filter_name—Set filter by dataset field.
  • filter_value—Set filter by applying a value to the selected field.
  • include—Set filter by including or excluding field values.
Value Table
max_count
(Optional)

The limit for the number of returned features. The default value is 1000000.

Long
business_dataset
(Optional)

The dataset that will be used in the business search.

String

Code sample

GeneratePointsFromBusinessListings example (Python window)

The following Python window script demonstrates how to use the GeneratePointsFromBusinessListings function.

import arcpy
arcpy.ba.GeneratePointsFromBusinessListings("MyProject.gdb\output", "San Francisco Bay Area", "coffee", False, False, 100, "salesvol min:200 INCLUDE;empnum 'min:3 max:10' INCLUDE;city 'Mountain View' EXCLUDE")

Licensing information

  • Basic: Requires Business Analyst
  • Standard: Requires Business Analyst
  • Advanced: Requires Business Analyst

Related topics