File: ReadMe.txt

MapPoint PHP API

1. System Requirements
----------------------

You need PHP 5.0.5 installed.

2. Configuration
----------------

Enable the soap extension in php.ini file (extension=php_soap.dll on Windows systems);
Set 'soap.wsdl_cache_enabled' to 1 (one) in php.ini file.

3. Running the samples
----------------------

Place the 2 folders and index.php in a web folder. Your directory structure should look like this:

aWebFolder
----------
    |
    |
    --- mappoint
    |
    |
    --- samples
    |
    |
    --- index.php
    
You'll need to set some values, such as your MapPoint Web Service username and password. Go to
mappoint folder and open the file ClassLoader.php. Here, you'll find some constants definitions that you
must set so that the samples work correctly. After doing that, you may test the samples by opening the
file index.php in your browser. Note that you must always start by this file because i use session 
variables that are created there.

4. Documentation
----------------

This API is not very well documented. Why? Because the documentation already exists. You can view the 
Microsoft MapPoint Web Service documentation online or you can download it for free (you'll need the .NET 
Framework 1.1 or the Visual Studio .NET). This whole API was made based on the information of the 
MapPoint documentation (which, imho, is very good).

5. Bugs
-------

The API will not work if you have to connect through a proxy. This a known bug of SoapClient PHP object 
with digest authentication. Most probably in future versions this will be fixed. 



Have fun!