DOTS Address Geocode – International

• Introduction
• Integration Basics

Introduction

• DOTS Address Geocode – International (AGI) is a web service that provides latitude/longitude and metadata information for international addresses and places. AGI is designed to take an international address, geocode it and then return a set of latitudinal and longitudinal coordinates along with any available address component information. The AGI service can also be used to search for and geocode non-address places such as neighborhoods, cities and regions by name.

Developer Guide Map

• Operations
  • This section lists the DOTS Address Geocode – International operations and goes into the details behind the inputs and outputs. 
    • Operations:
      • PlaceSearch
      • ReverseSearch
• Errors
  • This section reflects details on the error outputs that can happen with the service.
• Code Snippets and Sample Code
  • Here you’ll find code snippets for various programming languages and frameworks along with links to our sample code page on the web site.
• Try The API
  • This is where you’ll go to take the API for a spin.  There you can test the operation PlaceSearch.
• Service Reference
  • In this section you’ll find all the different endpoints supported by this service, input and output schema information as well as an opportunity to try the other endpoints as well.
• Frequently Asked Questions
  • This is a list of some of the questions we hear more often that you can reference and get answers on right away.

Integration Basics

• Integrating DOTS Address Geocode – International into your application should be easy and straightforward. If you are using a common platform, Service Objects may already have sample code built that you can use:
  AGI – Code Snippets and Sample Code
• However, if you are using a common platform that does not already have sample code, you can ask Service Objects to build you an example. Email support@serviceobjects.com for more details.

• Web Service Structure

• Web services are methods that integrate with other applications via the web, and encapsulate complex business logic. Web services are too large a topic to cover in this document, but Service Objects has developed its web services to be as easy to integrate and as accessible as possible.
• DOTS Address Geocode – International is a public JSON and XML web service that supports GET, POST and SOAP operations.

• The host path, or physical location of the web service is here:
  https:/trial.serviceobjects.com/AGI/

• Service JSON Request Help Page
• https://trial.serviceobjects.com/agi/api.svc/json/help

• Service XML Request Help Page
• https://trial.serviceobjects.com/agi/api.svc/xml/help

• The location of the WSDL, or Web Service Definition Language document, is here (This is also accessible via the “Service Definition” link.):
  https://trial.serviceobjects.com/agi/soap.svc?wsdl

This XML is the definition of the web service, meaning its inputs, outputs, operations, and the like. Most likely, you will have another tool read this WSDL and make the operations available to you in your application. Whenever your utilities or IDE asks for a WSDL path to DOTS Address Geocode – International, you can provide this one.