Integration with Web Map Services: General Information

Address data quality is essential for many business operations. The integration of MYOB Acumatica with web map services gives users the ability to maximize the accuracy of address information.

Learning Objectives

In this chapter, you will learn how to do the following:

  • Set up integration with the Google Maps web map service
  • Set up integration with the Bing Maps web map service

Applicable Scenarios

You may need to set up integration with web map services in scenarios that include the following:

  • Users need to find a company address by a company name.
  • Users need to find a company address by a postal code if no other address details are available.
  • Users need to find a full address by a street address.

Address Enrichment Functionality Through Web Map Services

With the address enrichment functionality through integration with web map services, you can add a new address, update an existing address, and fill in the missing address information in a record that has address settings. To make this functionality available, you must enable the Address Lookup Integration feature on the Enable/Disable Features (CS100000) form in the Customer Management group of features. You then need to set up integration with the web map service on the Address Providers (CS103000) form and select the address provider on the Site Preferences (SM200505) form, as described in Integration with Web Map Services: Implementation Activity.

As a result, the selected web map service will be used as the address provider on all forms that have address information[1]JaniceWhy is this needed? We already said "on all forms that have address information"--so we have narrowed the scope of applicable forms and told the reader what the scope is. If there is something else you want to convey about when it is or is not used/applicable, explicitly explain this.c55_zdd_ymb2020/09/0113:42:10-04:00eleonora.zilbermanBecause in fact it is not applicable to all the forms, to many of them, but not all.1c55_zdd_ymb12020/09/0811:03:53+03:00 (if applicable).

The Address Lookup Integration feature can also be used for the MYOB Acumatica Customer Portal: To do so, after the Address Lookup Integration feature has been enabled on the Enable/Disable Features (CS100000) form and the address provider has been set up on the Address Providers (CS103000) form, you should set up the address provider on the Portal Preferences (SP800000) form.

Web Map Services as Address Providers

MYOB Acumatica provides integration with the Google Maps and Bing Maps web map services. On the Address Providers (CS103000) form, you need to enter an identifier for the provider in the Provider ID box and select either of the following plug-ins in the Plug-In box:

  • Google Maps
  • Bing Maps

When the plug-in has been selected, on the Plug-In Parameters tab of the form, you need to specify values in the Value column for the following parameters:

  • API KEY: You get an API key when you register with the particular web map service that you are planning to use. This key should be entered here.
  • COUNTRY: You specify the ISO 3166 country code (For details, see https://www.iso.org/iso-3166-country-codes.html.) for each country in which users can search for addresses, with the codes separated by commas. [2]JaniceOkay, but what does this mean? We use "predefined" to describe entities or settings that are defined (not specified anywhere) in Acumatica ERP out of the box for users. But these are countries supported by the WMS, aren't they? As such, should we really be saying predefined, or should we be saying these are the countries that are selected by default for the provider because they are *supported by* the provider? It looks like you do not actually need to specify the codes because they are already filled in when you select a plug-in. (Did we mean that these are the countries **filled in by default** because they are supported by the provider rather than saying they are predefined countries, which implies creation in Acumatica ERP?) Is the point we want to make that the codes of these countries are filled in automatically, but you can add other codes, depending on the provider, up to its maximum allowable number? We should probably add a sentence saying this (or whatever the truth is). I know the Attention note has some usage info, but it seems that it is just telling how many countries, maximum, you can select. It doesn't help the reader understand what we mean by "predefined" in the context of integration (meaning that two products are in the picture, so "predefined" begs the question of where) or what is filled in by default and whether it can be changed.bcd_d2d_ymb2020/09/0114:32:10-04:00eleonora.zilbermanReplaced "predefined" with "supported".3bcd_d2d_ymb32020/09/0811:04:52+03:00The countries supported by the Google Maps address provider are the United States, the United Kingdom, Canada, and Mexico. The country supported by the Bing Maps address provider is the United States.
    Attention: A user can select up to five countries to be used for the address search by Google Maps and one country to be used for the address search by Bing Maps. The countries that are not [3]JaniceAgain, I don't think you should use this term. Are you really referring to whether the countries as entities are predefined in one of the products or whether they are supported or something else?2020/09/0114:45:58-04:00supported by the web map services may have different address templates used by postal services, and MYOB cannot guarantee that the data from these templates will be correctly processed by the system.