README_EN.md

Convert Text Addresses to Geographic Coordinates on a Map

English Version | 中文版

• Visit Tencent Location Service, log in, and go to Console → Application Management → My Apps.
• Click "Add Key," enter a name (can be arbitrary), check "WebService API," click "Sigature Verification", read and agree to the terms, then click "Add".
• After successfully creating the key, click "Quota Management -> Account Limit", scroll to the second page(If you have translated the web page, there may be display problems here. Just select the fourth line), and click "Quota Allocation" under "Geocoding." Click quota allocation(below the "operate" col) for your newly created key and set an appropriate value (the default concurrency for this program is 5 requests per second), then submit.
• Go back to Application Management → My Apps, copy the Key, then click "Edit" and copy the Secret Key.

2. Configure the API Key

   • Download and unzip AddressMapper.zip from release.
   • In tencent_api.txt:
     • First line: Paste the Key from Tencent Location Service.
     • Second line: Paste the Secret Key.

   Example:

   JIRBZ-U2D3Z-JJPXW-7FHM4-BIPB6-ABCDE
   ketYpUGiZRIWFzr7Ow5W05GmXFABCDE

3. Prepare the Data File

   • Save address information in 1.xlsx.
   • The format should match Example.xlsx:
     • First column: Company name
     • Second column: Company address
     • Third column: Contact person (optional, can be left blank)

4. Run the Program

   • Double-click AddressMapper.exe, and the program will automatically generate a KML file.

5. View the Results

   • Install Google Earth Pro and open the KML file with it.
   • Alternatively, import the KML file in the web version or mobile app of Google Earth.
   • For users in China, Ovital Maps is a better alternative.