You might ask: Why install a decade-old mapping component?
After a successful full source install, create a demo:
UniGMap1.MapType := mtOpenStreetMap;
UniGMap1.Zoom := 12;
UniGMap1.Center := TPointF.Create(139.6917, 35.6895); // Tokyo Station
UniGMap1.Active := True;
If tiles are black or white, check your internet proxy settings in
UniGMap_TileEngine.pas. Add a user-agent string:Http.UserAgent := 'Mozilla/5.0 (Tokyo Delphi)';
Unigui 1.48 was designed to work with:
UniGMap was developed as a specialized wrapper component. Its goal was simple but ambitious: abstract the complexity of the Google Maps JavaScript API v3 into native Delphi properties and events.
Instead of writing JavaScript strings like map.setCenter(new google.maps.LatLng...), a Delphi developer could simply write:
UniGMap1.SetCenter(Latitude, Longitude);
Version 1.48 represented a mature stage in this evolution. By this build, the component had moved past basic map rendering. It introduced advanced features crucial for enterprise apps: marker clustering, custom polygon drawing, and crucially, bidirectional communication. It wasn't just about showing a map; it was about the map sending data back to Delphi—capturing a user's click and translating it into coordinates the application could use for logistics, CRM, or tracking systems.
Add this to your project’s Conditional defines:
TOKYO;UNICODE;NO_TNT
Then in UniGMap_Defines.inc, insert:
$IFDEF TOKYO
$DEFINE DELPHI_102
$DEFINE NO_WINDOWS_UNIT
$ENDIF
If you hit a blocker, search for “UniGMap 148 GitHub fork” – the community maintains patched versions for Delphi 11 Alexandria and beyond. But your XE2/Tokyo setup is now a golden reference.
Next step: Implement a local tile server using TUniGMapOfflineSource – but that is an article for another day.
Keywords used organically: unigmap 148 xe2delphi 102 tokyo full source install, Delphi 10.2 Tokyo, UniGMap components, source porting, Graphics32, legacy GIS Delphi.
The installation of UniGMap 148 for Delphi 10.2 Tokyo involves several specific steps to ensure the full source code integrates correctly with the IDE. UniGMap is a powerful component library that allows developers to integrate Google Maps into Delphi VCL and FireMonkey applications using the Google Maps API.
To begin the installation, extract the full source archive to a permanent directory on your machine. Avoid using temporary folders, as Delphi needs a consistent path to reference the source files during compilation and at runtime. Once extracted, open Delphi 10.2 Tokyo and navigate to the Tools menu, then select Options. Under the Environment Options, locate the Delphi Options and then the Library page. Add the path to the UniGMap source folder to the Library Path for all relevant platforms, such as 32-bit and 64-bit Windows.
The next phase is the package compilation. Locate the package files within the extracted source—usually with a .dpk extension. For Delphi 10.2 Tokyo, look for the package specifically labeled for "Tokyo" or "D102". Open the runtime package first, right-click it in the Project Manager, and select Compile. After the runtime package is compiled, open the design-time package. Right-click this package, select Compile, and then select Install. If successful, you will receive a confirmation message, and the UniGMap components will appear in your Tool Palette under a new category.
Configuration of the Google Maps API key is a critical final step. Because UniGMap relies on the Google Maps JavaScript API, you must generate a valid API key through the Google Cloud Console. Once you have the key, you can assign it to the TUniGMap component properties within your Delphi project. This ensures that the map tiles and geocoding services load correctly without "Development Purpose Only" watermarks. unigmap 148 xe2delphi 102 tokyo full source install
If you encounter errors during the installation, ensure that no previous versions of UniGMap are present in your library paths. Conflicting BPL files are a common cause of installation failure. Additionally, verify that you have administrative privileges if you are installing the components into protected system directories. To help me tailor the next steps for your project: Are you targeting VCL or FireMonkey? Do you need help generating a Google API key? Are you seeing a specific error code?
I can provide a code snippet for basic map initialization once the components are installed.
If you are looking to perform a full source installation of a component suite (like uniGUI) for Delphi 10.2 Tokyo, follow these general steps adapted from standard manual installation practices: 1. Preparation
Close the IDE: Ensure Delphi 10.2 Tokyo is completely closed before starting the installation.
Administrator Rights: Always run the installer or your IDE with the same user privileges used during the initial Delphi installation to avoid registry or folder permission issues. 2. Full Source Compilation
If you have the "Full Source" version, you must compile the packages for your specific IDE version (Delphi 10.2 Tokyo):
Locate the Package Group: Look in the source folder for a .groupproj or multiple .dpk files. For Delphi 10.2, these are often labeled with D25, 102, or Tokyo (e.g., uniGUI_D10_2_Tokyo.groupproj). Open and Build: Open the project group in the Delphi IDE.
Right-click on the project group in the Project Manager and select Build All.
Note: Avoid using the "Clean" command, as it can delete essential pre-compiled files needed for some installations. Install Design-Time Packages:
Locate the packages ending in dcl... (design-time packages).
Right-click these specific packages and select Install. A dialog should appear confirming the components have been registered. 3. Configuring Library Paths
The IDE needs to know where to find the source and compiled files (.dcu) to compile your projects: Go to Tools > Options. Navigate to Language > Delphi > Library. Select the target platform (e.g., Windows 32-bit).
In the Library Path, add the full paths to the following folders: The \Source folder.
The \Lib or \DCU folder where the .dcu files were generated during the build step.
Repeat this for other platforms (like Windows 64-bit) if you plan to target them. 4. Verification Create a new VCL Forms Application. You might ask: Why install a decade-old mapping component
Check the Component Palette for the new tab (e.g., "uniGUI" or "Devart").
Drop a component onto the form and try to Compile (Ctrl+F9) to ensure the library paths are correctly configured.
For official documentation on specific suites, you can refer to the Devart UniDAC Installation Guide or the uniGUI Commercial Installation Guide. Installing Component Packages Manually - Embarcadero Blogs
Unigmap 148 is a powerful mapping component suite for Delphi developers, and installing it with full source on Delphi 10.2 Tokyo requires a specific sequence of steps to ensure pathing and library references are handled correctly. Prerequisites Before starting the installation, ensure you have: Delphi 10.2 Tokyo installed and updated. The Unigmap 148 XE2-XE10.2 source code package. Administrative rights on your workstation. Step 1: Prepare the Source Directory
Extract your Unigmap 148 source files to a permanent location (e.g., C:\Components\Unigmap).
Avoid using the Delphi program folder to prevent permission issues.
Ensure the folder structure contains the Source, Lib, and Packages subdirectories. Step 2: Configure Delphi Library Paths
Delphi needs to know where the source files are located to compile the packages. Open Delphi 10.2 Tokyo. Go to Tools > Options.
Navigate to Environment Options > Java/C++ > Delphi Options > Library. Select the 32-bit Windows platform.
Click the ellipsis next to Library path and add the path to the Unigmap Source folder.
Repeat this for the 64-bit Windows platform if you plan to build 64-bit applications. Step 3: Install the Packages In Delphi, go to File > Open Project. Navigate to the Unigmap Packages folder.
Look for the package file corresponding to your version (often named Unigmap_D102.dpk or similar). Right-click on the Project Group in the Project Manager. Click Build All to compile the source code.
Right-click on the Design-time package (usually has 'D' or 'Design' in the name) and select Install.
A dialog box should appear confirming the registration of new components. Troubleshooting Tips
🚩 Missing .dcu errors: Ensure your Library Path points exactly to the folder containing the .pas files. After a successful full source install , create a demo:
🚩 BPL Errors: If Delphi complains about missing .bpl files at startup, copy the compiled .bpl from your project output folder to C:\Windows\SysWOW64.
🚩 Version Mismatch: If the package was originally for XE2, you may need to update the requires section of the .dpk file to point to rtl250.dcp and vcl250.dcp (the versions for Tokyo). Key Features of Unigmap 148 Supports multiple map providers (Google, OSM, Bing).
Full source access allows for deep customization of marker logic.
High-performance rendering optimized for the Tokyo VCL framework.
Unigmap 148 XE2/Delphi 102 Tokyo: A Comprehensive Guide to Full Source Installation
Unigmap is a popular mapping and geographic information system (GIS) library used in various applications, including Delphibased projects. The latest version, Unigmap 148, is compatible with Embarcadero's Delphi 102 Tokyo, offering a wide range of features and improvements. In this article, we will walk you through the process of installing Unigmap 148 XE2/Delphi 102 Tokyo from full source, highlighting the benefits, system requirements, and a step-by-step installation guide.
What is Unigmap?
Unigmap is a powerful and flexible mapping library designed for developers to integrate geographic information systems (GIS) into their applications. It provides a wide range of features, including support for various map formats, markers, overlays, and more. Unigmap is widely used in industries such as logistics, transportation, urban planning, and environmental monitoring.
Benefits of Using Unigmap 148 XE2/Delphi 102 Tokyo
The latest version of Unigmap, version 148, offers several benefits, including:
System Requirements
Before installing Unigmap 148 XE2/Delphi 102 Tokyo, ensure your system meets the following requirements:
Step-by-Step Installation Guide
To install Unigmap 148 XE2/Delphi 102 Tokyo from full source, follow these steps: