{"id":1903,"date":"2022-11-08T01:37:33","date_gmt":"2022-11-08T01:37:33","guid":{"rendered":"https:\/\/serviceobjects.wpaladdin.com\/?post_type=serviceobjects&#038;p=1903"},"modified":"2026-03-02T10:03:29","modified_gmt":"2026-03-02T18:03:29","slug":"agi-placesearch","status":"publish","type":"page","link":"https:\/\/www.serviceobjects.com\/docs\/dots-address-geocode-international\/agi-operations\/agi-placesearch\/","title":{"rendered":"AGI &#8211; PlaceSearch"},"content":{"rendered":"<nav class=\"is-style-bullets-list\" aria-label=\"PlaceSearch Navigation\">\n<ul>\n<li><a href=\"#AGI-PlaceSearch-URLEndpoints\">URL Endpoints<\/a><\/li>\n<li><a href=\"#AGI-PlaceSearch-HTTPGETRequestHelpPage\">HTTP GET Request Help Page<\/a><\/li>\n<li><a href=\"#AGI-PlaceSearch-HTTPPOSTRequestHelpPage\">HTTP POST Request Help Page<\/a><\/li>\n<li><a href=\"#AGI-PlaceSearch-PlaceSearchInputs\">PlaceSearch Inputs<\/a><\/li>\n<li><a href=\"#AGI-PlaceSearch-PlaceSearchOutputs\">PlaceSearch Outputs<\/a><\/li>\n<li><a href=\"#AGI-PlaceSearch-References\">References<\/a><\/li>\n<\/ul>\n<\/nav>\n<p>The PlaceSearch operation returns the latitude and longitude for a given International Address, along with additional address and location information.\u00a0It will attempt to geocode addresses at the property level, which is often a rooftop coordinate for some properties and then cascade to the next best available resolution such as the street, neighborhood, postal code, locality and so on. For non-address places such as streets, cities and postal codes, the coordinates will return a coordinate point that is commonly associated with the location or a centroid for the area.<\/p>\n<p>&nbsp;<\/p>\n<section aria-labelledby=\"AGI-PlaceSearch-URLEndpoints\">\n<h2 id=\"AGI-PlaceSearch-URLEndpoints\" class=\"wp-block-heading\">URL Endpoints<\/h2>\n<ul class=\"is-style-no-bullets-indented-list\">\n<li><strong>JSON<\/strong>\n<ul>\n<li><a href=\"https:\/\/trial.serviceobjects.com\/agi\/api.svc\/json\/PlaceSearch?SingleLine={Singe%20Line%20Address}&amp;Address1={Address%201}&amp;Address2={Address%202}&amp;Address3={Address%203}&amp;Address4={Address%204}&amp;Address5={Address%205}&amp;Locality={Locality}&amp;AdministrativeArea={Administrative%20Area}&amp;PostalCode={Postal%20Code}&amp;Country={Country}&amp;Boundaries={Results%20Boundaries}&amp;MaxResults={Maximum%20Results}&amp;SearchType={Search%20Type}&amp;Extras={Extras}&amp;LicenseKey={LICENSEKEY}\" target=\"_blank\" rel=\"noreferrer noopener\">https:\/\/trial.serviceobjects.com\/agi\/api.svc\/json\/PlaceSearch?SingleLine={Singe\u00a0Line Address}&amp;Address1={Address 1}&amp;Address2={Address 2}&amp;Address3={Address 3}&amp;Address4={Address 4}&amp;Address5={Address 5}&amp;Locality={Locality}&amp;AdministrativeArea={Administrative Area}&amp;PostalCode={Postal Code}&amp;Country={Country}&amp;Boundaries={Results Boundaries}&amp;MaxResults={Maximum Results}&amp;SearchType={Search Type}&amp;Extras={Extras}&amp;LicenseKey={LICENSEKEY}<\/a><\/li>\n<\/ul>\n<\/li>\n<li><strong>XML<\/strong>\n<ul>\n<li><a href=\"https:\/\/trial.serviceobjects.com\/agi\/api.svc\/xml\/PlaceSearch?SingleLine={Singe%20Line%20Address}&amp;Address1={Address%201}&amp;Address2={Address%202}&amp;Address3={Address%203}&amp;Address4={Address%204}&amp;Address5={Address%205}&amp;Locality={Locality}&amp;AdministrativeArea={Administrative%20Area}&amp;PostalCode={Postal%20Code}&amp;Country={Country}&amp;Boundaries={Results%20Boundaries}&amp;MaxResults={Maximum%20Results}&amp;SearchType={Search%20Type}&amp;Extras={Extras}&amp;LicenseKey={LICENSEKEY}\" target=\"_blank\" rel=\"noreferrer noopener\">https:\/\/trial.serviceobjects.com\/agi\/api.svc\/xml\/PlaceSearch?SingleLine={Singe\u00a0Line Address}&amp;Address1={Address 1}&amp;Address2={Address 2}&amp;Address3={Address 3}&amp;Address4={Address 4}&amp;Address5={Address 5}&amp;Locality={Locality}&amp;AdministrativeArea={Administrative Area}&amp;PostalCode={Postal Code}&amp;Country={Country}&amp;Boundaries={Results Boundaries}&amp;MaxResults={Maximum Results}&amp;SearchType={Search Type}&amp;Extras={Extras}&amp;LicenseKey={LICENSEKEY}<\/a><\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<\/section>\n<div style=\"display:flex; gap:16px; flex-wrap:wrap; margin:24px 0;\">\n<div style=\"border: 1px solid #d1d5db; border-radius: 8px; padding: 16px; max-width: 320px; background: #f9fafb; flex: 1;\">\n<h3 style=\"margin-top: 0; margin-bottom: 8px; font-size: 1.2em;\">Run This Request in Postman<\/h3>\n<p style=\"margin: 0; line-height: 1.4;\">Test with this address:<br \/>\n<a style=\"font-weight: bold; color: #2563eb; text-decoration: none;\" href=\"https:\/\/www.postman.com\/service-objects-api\/service-objects\/example\/41579131-34c15c38-2bbd-4e01-8a44-5416ccbb5534\" target=\"_blank\" rel=\"noopener\"><br \/>\n350 Place Royale<br \/>\nMontreal QC H2Y 3Y5<br \/>\nCanada<br \/>\n<\/a><\/p>\n<\/div>\n<div style=\"border: 1px solid #d1d5db; border-radius: 8px; padding: 16px; max-width: 320px; background: #f9fafb; flex: 1;\">\n<h3 style=\"margin-top: 0; margin-bottom: 8px; font-size: 1.2em;\">Check out the Integration Code in GitHub<br \/><\/h3>\n<p style=\"margin: 0; line-height: 1.4;\"><a style=\"font-weight: bold; color: #2563eb; text-decoration: none;\" href=\"https:\/\/github.com\/ServiceObjects\/address-geocode-international\" target=\"_blank\" rel=\"noopener\"><br \/>\nGitHub<br \/>\n<\/a><\/p>\n<\/div>\n<\/div>\n<section aria-labelledby=\"AGI-PlaceSearch-HTTPGETRequestHelpPage\">\n<h2 id=\"AGI-PlaceSearch-HTTPGETRequestHelpPage\" class=\"wp-block-heading\">HTTP GET Request Help Page<\/h2>\n<ul class=\"is-style-no-bullets-indented-list\">\n<li><strong>JSON<\/strong>\n<ul>\n<li><a href=\"https:\/\/trial.serviceobjects.com\/AGI\/api.svc\/json\/help\/operations\/PlaceSearch#response-json\" target=\"_blank\" rel=\"noreferrer noopener\">https:\/\/trial.serviceobjects.com\/AGI\/api.svc\/json\/help\/operations\/PlaceSearch#response-json<\/a><\/li>\n<\/ul>\n<\/li>\n<li><strong>XML<\/strong>\n<ul>\n<li><a href=\"https:\/\/trial.serviceobjects.com\/AGI\/api.svc\/xml\/help\/operations\/PlaceSearch\" target=\"_blank\" rel=\"noreferrer noopener\">https:\/\/trial.serviceobjects.com\/AGI\/api.svc\/xml\/help\/operations\/PlaceSearch<\/a><\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<\/section>\n<section aria-labelledby=\"AGI-PlaceSearch-HTTPPOSTRequestHelpPage\">\n<h2 id=\"AGI-PlaceSearch-HTTPPOSTRequestHelpPage\" class=\"wp-block-heading\">HTTP POST Request Help Page<\/h2>\n<ul class=\"is-style-no-bullets-indented-list\">\n<li><strong>JSON<\/strong>\n<ul>\n<li><a href=\"http:\/\/trial.serviceobjects.com\/AGI\/api.svc\/json\/help\/operations\/PlaceSearch_POST#request-json\" target=\"_blank\" rel=\"noreferrer noopener\">https:\/\/trial.serviceobjects.com\/AGI\/api.svc\/json\/help\/operations\/PlaceSearch_POST#request-json<\/a><\/li>\n<\/ul>\n<\/li>\n<li><strong>XML<\/strong>\n<ul>\n<li><a href=\"http:\/\/trial.serviceobjects.com\/AGI\/api.svc\/xml\/help\/operations\/PlaceSearch_POST\" target=\"_blank\" rel=\"noreferrer noopener\">https:\/\/trial.serviceobjects.com\/AGI\/api.svc\/xml\/help\/operations\/PlaceSearch_POST<\/a><\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<\/section>\n<section aria-labelledby=\"AGI-PlaceSearch-PlaceSearchInputs\">\n<h2 id=\"AGI-PlaceSearch-PlaceSearchInputs\" class=\"wp-block-heading\">PlaceSearch Inputs<\/h2>\n<figure class=\"wp-block-table is-style-table-section\">\n<table>\n<thead>\n<tr>\n<th>Name<\/th>\n<th>Type<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>SingleLine **<\/td>\n<td>String<\/td>\n<td>The full address on one line.<\/td>\n<\/tr>\n<tr>\n<td>Address1<\/td>\n<td>String<\/td>\n<td>Address Line 1 of the International Address.<\/td>\n<\/tr>\n<tr>\n<td>Address2<\/td>\n<td>String<\/td>\n<td>Address Line 2 of the International Address.<\/td>\n<\/tr>\n<tr>\n<td>Address3<\/td>\n<td>String<\/td>\n<td>Address Line 3 of the International Address.<\/td>\n<\/tr>\n<tr>\n<td>Address4<\/td>\n<td>String<\/td>\n<td>Address Line 4 of the International Address.<\/td>\n<\/tr>\n<tr>\n<td>Address5<\/td>\n<td>String<\/td>\n<td>Address Line 5 of the International Address.<\/td>\n<\/tr>\n<tr>\n<td>Locality<\/td>\n<td>String<\/td>\n<td>The name of the distinct population cluster, such as a City, Town or other type of Municipality.<\/td>\n<\/tr>\n<tr>\n<td>AdministrativeArea<\/td>\n<td>String<\/td>\n<td>The name of the administrative division. Commonly the primary division of a country, such as a State, Region, Province, County, Territory or Prefecture.<\/td>\n<\/tr>\n<tr>\n<td>PostalCode<\/td>\n<td>String<\/td>\n<td>The postal code of the international address or its equivalent, such as a ZIP code (US), PLZ (DE, AU, and CH), PIN code (IN) and CAP (IT). It is recommended that the postal code be formatted to contain a strong resemblance to the proper country specific format, and that you do not precede the postal code with a country or region code. For example, use &#8216;09170&#8217; instead of &#8216;FR-9170&#8217;.<\/td>\n<\/tr>\n<tr>\n<td>Country\u00a0<strong>*<\/strong><\/td>\n<td>String<\/td>\n<td>The preferred name of the country or the ISO 3166-1 Alpha-2 Country Code or the Alpha-3 Country Code. Some alternate country names and spellings are supported, but the use of the common English spelled name or ISO2 country code is recommended for best results.<\/td>\n<\/tr>\n<tr>\n<td>Boundaries<\/td>\n<td>String<\/td>\n<td>*Coming soon, not currently used &#8211; A comma-delimited list of coordinates that form a rectangular boundary in which to focus your search on. See &#8220;Boundaries&#8221; for more information.<\/td>\n<\/tr>\n<tr>\n<td>MaxResults<\/td>\n<td>String<\/td>\n<td>Sets the maximum number of results the operation is allowed to return. Acceptable values range from 1 to 10. Defaults to 10 if no value is given. Note that by default, the operation will try to return a single best match, but if the result is ambiguous or if the SearchType &#8216;ALL&#8217; is used then the operation will return no more than the given value.<\/td>\n<\/tr>\n<tr>\n<td>SearchType<\/td>\n<td>String<\/td>\n<td>The name of the type of search you want to perform for the given address or place. Defaults to &#8216;BestMatch&#8217; if no value is provided. See &#8220;<a href=\"\/docs\/dots-address-geocode-international\/agi-operations\/agi-placesearch\/agi-addl-inputs-and-outputs-placesearch\/\" target=\"_blank\" rel=\"noreferrer noopener\">Search Types<\/a>&#8221; for more information.<\/td>\n<\/tr>\n<tr>\n<td>Extras<\/td>\n<td>String<\/td>\n<td>A comma-delimited list of the extra features that you would like to enable on this search. See &#8220;<a href=\"\/docs\/dots-address-geocode-international\/agi-operations\/agi-placesearch\/agi-addl-inputs-and-outputs-placesearch\/#AGI-Add%27lInputsandOutputs-PlaceSearch-Extras\" target=\"_blank\" rel=\"noreferrer noopener\">Extras<\/a>&#8221; for more information.<\/td>\n<\/tr>\n<tr>\n<td>LicenseKey\u00a0<strong>*<\/strong><\/td>\n<td>String<\/td>\n<td>Your license key to use the service.<br \/>\nSign up for a free trial key at<br \/>\n<a href=\"https:\/\/www.serviceobjects.com\/address-geocode\/\" target=\"_blank\" rel=\"noreferrer noopener\">https:\/\/www.serviceobjects.com\/address-geocode\/<\/a><\/td>\n<\/tr>\n<\/tbody>\n<\/table><figcaption class=\"wp-element-caption\"><strong>*\u00a0 \u00a0Required<\/strong><br \/>\n<strong>**\u00a0<\/strong>For best performance and results it is recommended to use parsed address inputs rather than a single line address. This is because there are less ambiguities with parsed inputs than SingleLine and the service has more options for trying to find a match.<\/figcaption><\/figure>\n<\/section>\n<section aria-labelledby=\"AGI-PlaceSearch-PlaceSearchOutputs\">\n<h2 id=\"AGI-PlaceSearch-PlaceSearchOutputs\" class=\"wp-block-heading\">PlaceSearch Outputs<\/h2>\n<ul class=\"is-style-no-bullets-indented-list\">\n<li>All of the response objects are contained within the\u00a0<em>SearchResponse<\/em>\u00a0object.<\/li>\n<li><mark class=\"has-inline-color\" style=\"color: #5e6c84;\"><em>SearchResponse<\/em><\/mark><\/li>\n<\/ul>\n<div class=\"wp-block-group\">\n<figure class=\"wp-block-table is-style-table-section\">\n<table>\n<thead>\n<tr>\n<th>Name<\/th>\n<th>Type<\/th>\n<th>Values<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>SearchInfo<\/td>\n<td>SearchInfo<\/td>\n<td>Varies<\/td>\n<td>Contains status, notes and warning information<br \/>\nabout the query as well as the number of locations<br \/>\nreturned. This object is always returned.<\/td>\n<\/tr>\n<tr>\n<td>Locations<\/td>\n<td>LocationInfo[]<\/td>\n<td>Varies<\/td>\n<td>Contains a list of LocationInfo objects. If a best<br \/>\nmatch is found then the service will contain a single<br \/>\nlocation. If a single best match cannot be found or<br \/>\nif the &#8216;SearchType&#8217; input value is set to &#8216;All&#8217; then the<br \/>\nlist will contain no more than the maximum number<br \/>\nof locations set by the &#8216;MaxResults&#8217; input.<\/td>\n<\/tr>\n<tr>\n<td><a href=\"\/docs\/dots-address-geocode-international\/agi-errors\/\" target=\"_blank\" rel=\"noreferrer noopener\">Error<\/a><\/td>\n<td>Error<\/td>\n<td>Varies<\/td>\n<td>Error object indicating why the service could not<br \/>\nreturn a result. See \u201c<a href=\"\/docs\/dots-address-geocode-international\/agi-errors\/\" target=\"_blank\" rel=\"noreferrer noopener\">Errors<\/a>\u201d\u00a0page for more information.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/figure>\n<\/div>\n<ul class=\"is-style-no-bullets-indented-list\">\n<li><em><mark class=\"has-inline-color\" style=\"color: #5e6c84;\"> SearchInfo<\/mark><\/em><\/li>\n<\/ul>\n<figure class=\"wp-block-table is-style-table-section\">\n<table>\n<thead>\n<tr>\n<th>Name<\/th>\n<th>Type<\/th>\n<th>Values<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>Status<\/td>\n<td>String<\/td>\n<td>See &#8220;<a href=\"\/docs\/dots-address-geocode-international\/agi-operations\/agi-placesearch\/agi-addl-inputs-and-outputs-placesearch\/#AGI-Add%27lInputsandOutputs-PlaceSearch-Status\" target=\"_blank\" rel=\"noreferrer noopener\">Status<\/a>&#8221; for descriptions and possible values.<\/td>\n<td>Indicates if the service found one or more results or if it encountered an error when processing the query.<\/td>\n<\/tr>\n<tr>\n<td>NumberOfLocations<\/td>\n<td>String<\/td>\n<td>Number<br \/>\nMax Range of<br \/>\n0 &#8211; 10<\/td>\n<td>Indicates the number of locations found for the query that will be listed in<br \/>\nLocationInfo array Locations. The default maximum number of location<br \/>\nreturned by the service is 10; however, a lower value can be set in the<br \/>\n&#8216;MaxResults&#8217; input.<\/td>\n<\/tr>\n<tr>\n<td>Notes<\/td>\n<td>String<br \/>\nor NULL<\/td>\n<td>See &#8220;<a href=\"\/docs\/dots-address-geocode-international\/agi-operations\/agi-placesearch\/agi-addl-inputs-and-outputs-placesearch\/#AGI-Add%27lInputsandOutputs-PlaceSearch-NoteCodes&amp;Descriptions\" target=\"_blank\" rel=\"noreferrer noopener\">Note Codes &amp; Descriptions<\/a>&#8221; for possible values and details.<\/td>\n<td>Comma-separated list of descriptive note codes about the query.<\/td>\n<\/tr>\n<tr>\n<td>NotesDesc<\/td>\n<td>String<br \/>\nor NULL<\/td>\n<td>See &#8220;<a href=\"\/docs\/dots-address-geocode-international\/agi-operations\/agi-placesearch\/agi-addl-inputs-and-outputs-placesearch\/#AGI-Add%27lInputsandOutputs-PlaceSearch-NoteCodes&amp;Descriptions\" target=\"_blank\" rel=\"noreferrer noopener\">Note Codes &amp; Descriptions<\/a>&#8221; for possible values and details.<\/td>\n<td>Comma-separated list of descriptions that correspond to the Notes output.<\/td>\n<\/tr>\n<tr>\n<td>Warnings<\/td>\n<td>String<br \/>\nor NULL<\/td>\n<td>See &#8220;Warning Codes &amp; Descriptions&#8221; for possible values and details.<\/td>\n<td>Comma-separated\u00a0list of warning codes about the query.<\/td>\n<\/tr>\n<tr>\n<td>WarningDesc<\/td>\n<td>String<br \/>\nor NULL<\/td>\n<td>See &#8220;Warning Codes &amp; Descriptions&#8221; for possible values and details.<\/td>\n<td>Comma-separated list of descriptions that correspond to the Warnings<br \/>\noutput.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/figure>\n<ul class=\"is-style-no-bullets-indented-list\">\n<li><em><mark class=\"has-inline-color\" style=\"color: #5e6c84;\"> LocationInfo<\/mark><\/em><\/li>\n<\/ul>\n<figure class=\"wp-block-table is-style-table-section\">\n<table>\n<thead>\n<tr>\n<th>Name<\/th>\n<th class=\"has-text-align-left\" data-align=\"left\">Type<\/th>\n<th>Values<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>PrecisionLevel<\/td>\n<td class=\"has-text-align-left\" data-align=\"left\">String<\/td>\n<td>Number<br \/>\nRanges 1<br \/>\n&#8211; 16<\/td>\n<td>Indicates how precise the<br \/>\ncoordinates are. Levels range<br \/>\nfrom 1 &#8211; 16. The higher the<br \/>\nnumber the higher the precision.<br \/>\nSee &#8220;<a href=\"\/docs\/dots-address-geocode-international\/agi-operations\/agi-placesearch\/agi-addl-inputs-and-outputs-placesearch\/#AGI-Add%27lInputsandOutputs-PlaceSearch-PrecisionLevels\" target=\"_blank\" rel=\"noreferrer noopener\">Precision Levels<\/a>&#8221; for more<br \/>\ndetails.<\/td>\n<\/tr>\n<tr>\n<td>Type<\/td>\n<td class=\"has-text-align-left\" data-align=\"left\">String<\/td>\n<td>See<br \/>\n&#8220;<a href=\"\/docs\/dots-address-geocode-international\/agi-operations\/agi-placesearch\/agi-addl-inputs-and-outputs-placesearch\/#AGI-Add%27lInputsandOutputs-PlaceSearch-Types\" target=\"_blank\" rel=\"noreferrer noopener\">Types<\/a>&#8221;<br \/>\nfor<br \/>\npossible<br \/>\nvalues<br \/>\nand<br \/>\ndetails.<\/td>\n<td>Indicates what type of location<br \/>\nthe coordinates are for. For<br \/>\nexample, the location may be for<br \/>\nan address, thoroughfare, locality<br \/>\nor postal code.<\/td>\n<\/tr>\n<tr>\n<td>Latitude<\/td>\n<td class=\"has-text-align-left\" data-align=\"left\">String<\/td>\n<td>Varies<\/td>\n<td>The latitude of the location.<br \/>\nA decimal number up to 10 digits<br \/>\nwith a max precision of up to 7<br \/>\nplaces after the decimal point.<\/td>\n<\/tr>\n<tr>\n<td>Longitude<\/td>\n<td class=\"has-text-align-left\" data-align=\"left\">String<\/td>\n<td>Varies<\/td>\n<td>The longitude of the location.<br \/>\nA decimal number up to 10 digits<br \/>\nwith a max precision of up to 7<br \/>\nplaces after the decimal point.<\/td>\n<\/tr>\n<tr>\n<td>AddressComponents<\/td>\n<td class=\"has-text-align-left\" data-align=\"left\">AddressComponents<\/td>\n<td>Varies<\/td>\n<td>A name-value pair collection<br \/>\ncontaining additional information<br \/>\nabout the location. See the<br \/>\n&#8220;AddressComponents&#8221;\u00a0table and<br \/>\nthe list of Components for more<br \/>\ndetails.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/figure>\n<ul class=\"is-style-no-bullets-indented-list\">\n<li><mark class=\"has-inline-color\" style=\"color: #5e6c84;\"><em>AddressComponents<\/em><\/mark><\/li>\n<\/ul>\n<figure class=\"wp-block-table is-style-table-section\">\n<table>\n<thead>\n<tr>\n<th>Name<\/th>\n<th>Type<\/th>\n<th>Values<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>PremiseNumber<\/td>\n<td>String or<br \/>\nNULL<\/td>\n<td>Varies<\/td>\n<td>The number associated with the<br \/>\nproperty. Also known as the<br \/>\nAddress, Street or House<br \/>\nnumber.<\/td>\n<\/tr>\n<tr>\n<td>Thoroughfare<\/td>\n<td>String or<br \/>\nNULL<\/td>\n<td>Varies<\/td>\n<td>The name of the thoroughfare.<br \/>\nAlso known as a street, road,<br \/>\nhighway, etc.<\/td>\n<\/tr>\n<tr>\n<td>DoubleDependentLocality<\/td>\n<td>String or<br \/>\nNULL<\/td>\n<td>Varies<\/td>\n<td>The name of the double<br \/>\ndependent locality.<\/td>\n<\/tr>\n<tr>\n<td>DependentLocality<\/td>\n<td>String or<br \/>\nNULL<\/td>\n<td>Varies<\/td>\n<td>The name of the dependent<br \/>\nlocality.<\/td>\n<\/tr>\n<tr>\n<td>Locality<\/td>\n<td>String or<br \/>\nNULL<\/td>\n<td>Varies<\/td>\n<td>The preferred English name of<br \/>\nthe locality, such as a City, Town<br \/>\nor other type of Municipality.<\/td>\n<\/tr>\n<tr>\n<td>AdministrativeArea1<\/td>\n<td>String or<br \/>\nNULL<\/td>\n<td>Varies<\/td>\n<td>The name of the primary<br \/>\nadministrative division, such as a<br \/>\nState, Region, Province, County,<br \/>\nTerritory or Prefecture.<\/td>\n<\/tr>\n<tr>\n<td>AdministrativeArea1Abbreviation<\/td>\n<td>String or<br \/>\nNULL<\/td>\n<td>Varies<\/td>\n<td>The abbreviated name of the<br \/>\nprimary administrative area.<\/td>\n<\/tr>\n<tr>\n<td>AdministrativeArea2<\/td>\n<td>String or<br \/>\nNULL<\/td>\n<td>Varies<\/td>\n<td>The name of the secondary<br \/>\nadministrative division, such as a<br \/>\nCounty or Region.<\/td>\n<\/tr>\n<tr>\n<td>AdministrativeArea2Abbreviation<\/td>\n<td>String or<br \/>\nNULL<\/td>\n<td>Varies<\/td>\n<td>The abbreviated name of the<br \/>\nsecondary administrative area.<\/td>\n<\/tr>\n<tr>\n<td>AdministrativeArea3<\/td>\n<td>String or<br \/>\nNULL<\/td>\n<td>Varies<\/td>\n<td>The name of the third level<br \/>\nadministrative division, such as a<br \/>\nBorough or District.<\/td>\n<\/tr>\n<tr>\n<td>AdministrativeArea3Abbreviation<\/td>\n<td>String or<br \/>\nNULL<\/td>\n<td>Varies<\/td>\n<td>The abbreviated name of the<br \/>\ntertiary administrative area.<\/td>\n<\/tr>\n<tr>\n<td>AdministrativeArea4<\/td>\n<td>String or<br \/>\nNULL<\/td>\n<td>Varies<\/td>\n<td>The name of the fourth level<br \/>\nadministrative division, such as a<br \/>\nWard or Quarter.<\/td>\n<\/tr>\n<tr>\n<td>AdministrativeArea4Abbreviation<\/td>\n<td>String or<br \/>\nNULL<\/td>\n<td>Varies<\/td>\n<td>The abbreviated name of the<br \/>\nquaternary\u00a0administrative area.<\/td>\n<\/tr>\n<tr>\n<td>PostalCode<\/td>\n<td>String or<br \/>\nNULL<\/td>\n<td>Varies<\/td>\n<td>The postal code of the<br \/>\ninternational address.<\/td>\n<\/tr>\n<tr>\n<td>Country<\/td>\n<td>String or<br \/>\nNULL<\/td>\n<td>Varies<\/td>\n<td>The country<\/td>\n<\/tr>\n<tr>\n<td>CountryISO2<\/td>\n<td>String or<br \/>\nNULL<\/td>\n<td>Varies<\/td>\n<td>The 2-letter country<br \/>\nabbreviation.<\/td>\n<\/tr>\n<tr>\n<td>CountryISO3<\/td>\n<td>String or<br \/>\nNULL<\/td>\n<td>Varies<\/td>\n<td>The 3-letter country<br \/>\nabbreviation.<\/td>\n<\/tr>\n<tr>\n<td>GoogleMapsURL **<\/td>\n<td>String or<br \/>\nNULL<\/td>\n<td>Varies<\/td>\n<td>Google Maps URL with the<br \/>\ncoordinates to the location.<\/td>\n<\/tr>\n<tr>\n<td>PlaceName *<\/td>\n<td>String or<br \/>\nNULL<\/td>\n<td>Varies<\/td>\n<td>County FIPS (Federal Information<br \/>\nProcessing Standard) code; used<br \/>\nto<br \/>\nuniquely\u00a0identify counties across<br \/>\nthe US.<\/td>\n<\/tr>\n<tr>\n<td>IsUnincorporated *<\/td>\n<td>String or<br \/>\nNULL<\/td>\n<td>Varies<\/td>\n<td>Indicates if the coordinates are<br \/>\nfor an unincorporated area. Only<br \/>\nappears for street level property<br \/>\nmatches (S).<br \/>\n1 &#8211; Indicates that the coordinates<br \/>\nfall within the boundaries of a<br \/>\nknown unincorporated area.<br \/>\n2 &#8211; Indicates that the coordinates<br \/>\nfall outside of the boundaries of<br \/>\na known area.<\/td>\n<\/tr>\n<tr>\n<td>StateFIPS *<\/td>\n<td>String or<br \/>\nNULL<\/td>\n<td>2 Digit<br \/>\nNumber<\/td>\n<td>State FIPS (Federal Information<br \/>\nProcessing Standard) code; used<br \/>\nto<br \/>\nuniquely identity states.<\/td>\n<\/tr>\n<tr>\n<td>CountyFIPS *<\/td>\n<td>String or<br \/>\nNULL<\/td>\n<td>3 Digit<br \/>\nNumber<\/td>\n<td>County FIPS (Federal Information<br \/>\nProcessing Standard) code;used<br \/>\nto<br \/>\nuniquely\u00a0identify counties across<br \/>\nthe US.<\/td>\n<\/tr>\n<tr>\n<td>CensusTract *<\/td>\n<td>String or<br \/>\nNULL<\/td>\n<td>6 Digit<br \/>\nDecimal<br \/>\nNumber<\/td>\n<td>The census tract of the given<br \/>\naddress.<br \/>\nA census tract is a statistical<br \/>\nsubdivision of a county.<\/td>\n<\/tr>\n<tr>\n<td>CensusBlock *<\/td>\n<td>String or<br \/>\nNULL<\/td>\n<td>4 Digit<br \/>\nNumber<\/td>\n<td>The census block of the given<br \/>\naddress.<br \/>\nA block is the smallest<br \/>\ngeographic unit used by the US<br \/>\nCensus.<\/td>\n<\/tr>\n<tr>\n<td>CensusGeoID *<\/td>\n<td>String or<br \/>\nNULL<\/td>\n<td>15 Digit<br \/>\nNumber<\/td>\n<td>A Census based geographic<br \/>\nidentification code that uniquely<br \/>\nidentifies a geographic statistical<br \/>\narea.<\/td>\n<\/tr>\n<tr>\n<td><a href=\"\/docs\/dots-address-geocode-us\/agus-classfp\/\" target=\"_blank\" rel=\"noreferrer noopener\">ClassFP<\/a>\u00a0*<\/td>\n<td>String or<br \/>\nNULL<\/td>\n<td>Alpha-<br \/>\nNumeric<\/td>\n<td>A code that defines the current<br \/>\nclass of the geographic US<br \/>\nlocation.<\/td>\n<\/tr>\n<tr>\n<td>CongressCode *<\/td>\n<td>String or<br \/>\nNULL<\/td>\n<td>Varies<\/td>\n<td>The congressional district<br \/>\nnumber.<\/td>\n<\/tr>\n<tr>\n<td>SLDUST *<\/td>\n<td>String or<br \/>\nNULL<\/td>\n<td>Varies<\/td>\n<td>Current state legislative district<br \/>\nupper (senate) chamber code.<\/td>\n<\/tr>\n<tr>\n<td>SLDLST *<\/td>\n<td>String or<br \/>\nNULL<\/td>\n<td>Varies<\/td>\n<td>Current state legislative district<br \/>\nlower (house) chamber code<\/td>\n<\/tr>\n<tr>\n<td>Timezone_UTC ***<\/td>\n<td>String or<br \/>\nNULL<\/td>\n<td>Number<\/td>\n<td>The time zone in UTC offset<br \/>\nformat.<\/td>\n<\/tr>\n<\/tbody>\n<\/table><figcaption class=\"wp-element-caption\">* Only available when &#8216;Census&#8217; is included in the input value for Extras.<br \/>\n**\u00a0Only available when &#8216;URLs&#8217; is included in the input value for Extras.<br \/>\n*** US Support Only. International\u00a0<br \/>\n<strong>** Coming Soon **<\/strong><\/figcaption><\/figure>\n<\/section>\n<section aria-labelledby=\"AGI-PlaceSearch-References\">\n<h1 id=\"AGI-PlaceSearch-References\" class=\"wp-block-heading is-style-no-bullets-indented-list\" style=\"font-size: 25px;\">References<\/h1>\n<\/section>\n","protected":false},"excerpt":{"rendered":"<p>URL Endpoints HTTP GET Request Help Page HTTP POST Request Help Page PlaceSearch Inputs PlaceSearch Outputs References The PlaceSearch operation returns the latitude and longitude for a given International Address, along with additional address and location information.\u00a0It will attempt to geocode addresses at the property level, which is often a rooftop coordinate for some properties [&hellip;]<\/p>\n","protected":false},"author":2,"featured_media":0,"parent":1771,"menu_order":0,"comment_status":"open","ping_status":"closed","template":"","meta":{"footnotes":""},"class_list":["post-1903","page","type-page","status-publish","hentry"],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v26.2 - https:\/\/yoast.com\/wordpress\/plugins\/seo\/ -->\n<title>AGI - PlaceSearch<\/title>\n<meta name=\"description\" content=\"URL Endpoints HTTP GET Request Help Page HTTP POST Request Help Page PlaceSearch Inputs PlaceSearch Outputs References The PlaceSearch operation returns\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/www.serviceobjects.com\/docs\/dots-address-geocode-international\/agi-operations\/agi-placesearch\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"AGI - PlaceSearch\" \/>\n<meta property=\"og:description\" content=\"URL Endpoints HTTP GET Request Help Page HTTP POST Request Help Page PlaceSearch Inputs PlaceSearch Outputs References The PlaceSearch operation returns\" \/>\n<meta property=\"og:url\" content=\"https:\/\/www.serviceobjects.com\/docs\/dots-address-geocode-international\/agi-operations\/agi-placesearch\/\" \/>\n<meta property=\"og:site_name\" content=\"Service Objects | Contact, Phone, Email Verification | Data Quality Services\" \/>\n<meta property=\"article:modified_time\" content=\"2026-03-02T18:03:29+00:00\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"8 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\/\/www.serviceobjects.com\/docs\/dots-address-geocode-international\/agi-operations\/agi-placesearch\/\",\"url\":\"https:\/\/www.serviceobjects.com\/docs\/dots-address-geocode-international\/agi-operations\/agi-placesearch\/\",\"name\":\"AGI - PlaceSearch\",\"isPartOf\":{\"@id\":\"https:\/\/www.serviceobjects.com\/docs\/#website\"},\"datePublished\":\"2022-11-08T01:37:33+00:00\",\"dateModified\":\"2026-03-02T18:03:29+00:00\",\"description\":\"URL Endpoints HTTP GET Request Help Page HTTP POST Request Help Page PlaceSearch Inputs PlaceSearch Outputs References The PlaceSearch operation returns\",\"breadcrumb\":{\"@id\":\"https:\/\/www.serviceobjects.com\/docs\/dots-address-geocode-international\/agi-operations\/agi-placesearch\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/www.serviceobjects.com\/docs\/dots-address-geocode-international\/agi-operations\/agi-placesearch\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/www.serviceobjects.com\/docs\/dots-address-geocode-international\/agi-operations\/agi-placesearch\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/www.serviceobjects.com\/docs\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"DOTS Address Geocode &#8211; International\",\"item\":\"https:\/\/www.serviceobjects.com\/docs\/dots-address-geocode-international\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"AGI &#8211; Operations\",\"item\":\"https:\/\/www.serviceobjects.com\/docs\/dots-address-geocode-international\/agi-operations\/\"},{\"@type\":\"ListItem\",\"position\":4,\"name\":\"AGI &#8211; PlaceSearch\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/www.serviceobjects.com\/docs\/#website\",\"url\":\"https:\/\/www.serviceobjects.com\/docs\/\",\"name\":\"Service Objects | Contact, Phone, Email Verification | Data Quality Services\",\"description\":\"\",\"publisher\":{\"@id\":\"https:\/\/www.serviceobjects.com\/docs\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/www.serviceobjects.com\/docs\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"},{\"@type\":\"Organization\",\"@id\":\"https:\/\/www.serviceobjects.com\/docs\/#organization\",\"name\":\"Service Objects | Contact, Phone, Email Verification | Data Quality Services\",\"url\":\"https:\/\/www.serviceobjects.com\/docs\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/www.serviceobjects.com\/docs\/#\/schema\/logo\/image\/\",\"url\":\"https:\/\/www.serviceobjects.com\/docs\/wp-content\/uploads\/2022\/08\/SO-logo-2560px-transparent.png\",\"contentUrl\":\"https:\/\/www.serviceobjects.com\/docs\/wp-content\/uploads\/2022\/08\/SO-logo-2560px-transparent.png\",\"width\":2560,\"height\":1440,\"caption\":\"Service Objects | Contact, Phone, Email Verification | Data Quality Services\"},\"image\":{\"@id\":\"https:\/\/www.serviceobjects.com\/docs\/#\/schema\/logo\/image\/\"}}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"AGI - PlaceSearch","description":"URL Endpoints HTTP GET Request Help Page HTTP POST Request Help Page PlaceSearch Inputs PlaceSearch Outputs References The PlaceSearch operation returns","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/www.serviceobjects.com\/docs\/dots-address-geocode-international\/agi-operations\/agi-placesearch\/","og_locale":"en_US","og_type":"article","og_title":"AGI - PlaceSearch","og_description":"URL Endpoints HTTP GET Request Help Page HTTP POST Request Help Page PlaceSearch Inputs PlaceSearch Outputs References The PlaceSearch operation returns","og_url":"https:\/\/www.serviceobjects.com\/docs\/dots-address-geocode-international\/agi-operations\/agi-placesearch\/","og_site_name":"Service Objects | Contact, Phone, Email Verification | Data Quality Services","article_modified_time":"2026-03-02T18:03:29+00:00","twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"8 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/www.serviceobjects.com\/docs\/dots-address-geocode-international\/agi-operations\/agi-placesearch\/","url":"https:\/\/www.serviceobjects.com\/docs\/dots-address-geocode-international\/agi-operations\/agi-placesearch\/","name":"AGI - PlaceSearch","isPartOf":{"@id":"https:\/\/www.serviceobjects.com\/docs\/#website"},"datePublished":"2022-11-08T01:37:33+00:00","dateModified":"2026-03-02T18:03:29+00:00","description":"URL Endpoints HTTP GET Request Help Page HTTP POST Request Help Page PlaceSearch Inputs PlaceSearch Outputs References The PlaceSearch operation returns","breadcrumb":{"@id":"https:\/\/www.serviceobjects.com\/docs\/dots-address-geocode-international\/agi-operations\/agi-placesearch\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/www.serviceobjects.com\/docs\/dots-address-geocode-international\/agi-operations\/agi-placesearch\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/www.serviceobjects.com\/docs\/dots-address-geocode-international\/agi-operations\/agi-placesearch\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/www.serviceobjects.com\/docs\/"},{"@type":"ListItem","position":2,"name":"DOTS Address Geocode &#8211; International","item":"https:\/\/www.serviceobjects.com\/docs\/dots-address-geocode-international\/"},{"@type":"ListItem","position":3,"name":"AGI &#8211; Operations","item":"https:\/\/www.serviceobjects.com\/docs\/dots-address-geocode-international\/agi-operations\/"},{"@type":"ListItem","position":4,"name":"AGI &#8211; PlaceSearch"}]},{"@type":"WebSite","@id":"https:\/\/www.serviceobjects.com\/docs\/#website","url":"https:\/\/www.serviceobjects.com\/docs\/","name":"Service Objects | Contact, Phone, Email Verification | Data Quality Services","description":"","publisher":{"@id":"https:\/\/www.serviceobjects.com\/docs\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/www.serviceobjects.com\/docs\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":"Organization","@id":"https:\/\/www.serviceobjects.com\/docs\/#organization","name":"Service Objects | Contact, Phone, Email Verification | Data Quality Services","url":"https:\/\/www.serviceobjects.com\/docs\/","logo":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/www.serviceobjects.com\/docs\/#\/schema\/logo\/image\/","url":"https:\/\/www.serviceobjects.com\/docs\/wp-content\/uploads\/2022\/08\/SO-logo-2560px-transparent.png","contentUrl":"https:\/\/www.serviceobjects.com\/docs\/wp-content\/uploads\/2022\/08\/SO-logo-2560px-transparent.png","width":2560,"height":1440,"caption":"Service Objects | Contact, Phone, Email Verification | Data Quality Services"},"image":{"@id":"https:\/\/www.serviceobjects.com\/docs\/#\/schema\/logo\/image\/"}}]}},"_links":{"self":[{"href":"https:\/\/www.serviceobjects.com\/docs\/wp-json\/wp\/v2\/pages\/1903","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.serviceobjects.com\/docs\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/www.serviceobjects.com\/docs\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/www.serviceobjects.com\/docs\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/www.serviceobjects.com\/docs\/wp-json\/wp\/v2\/comments?post=1903"}],"version-history":[{"count":41,"href":"https:\/\/www.serviceobjects.com\/docs\/wp-json\/wp\/v2\/pages\/1903\/revisions"}],"predecessor-version":[{"id":12589,"href":"https:\/\/www.serviceobjects.com\/docs\/wp-json\/wp\/v2\/pages\/1903\/revisions\/12589"}],"up":[{"embeddable":true,"href":"https:\/\/www.serviceobjects.com\/docs\/wp-json\/wp\/v2\/pages\/1771"}],"wp:attachment":[{"href":"https:\/\/www.serviceobjects.com\/docs\/wp-json\/wp\/v2\/media?parent=1903"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}