Forward

Convert addresses into geographic coordinates

Forward geocoding uses address information to return the coordinates of the area as a coordinate list of polygons.

See the API Key Issuance page for information on using keys.

Forward Geocoding

GET https://api.fatos.biz/nostra/api/geocoding/forward

https://api.fatos.biz/nostra/api/geocoding/forward?key=YOUR_API_KEY&q=starbucks&format=json&polygon=1&addressdetails=1

Query Parameters

Name	Type	Description
key	string	Your API Key.
format	string	[ xml | json ], output type methods.
q	string	String to search with a keyword. A comma as a delimiter is optional but recommended for performance improvement.
q(Korean)	string	Used when the keyword is Korean.
polygon	integer	[ 1 | 0 ] Display the retrieved items or not.
addressdetails	integer	[ 1 | 0 ] Whether to separate addresses into details.
acceptlanguage	string	countrycode[,countrycode][,countrycode] Limit search results to specific countries. (sg: singapore, th: thailand, id: indonesia, kr: korea, us: united states....)

200

[
   {
      "place_id":201729370,
      "licence":"Data © OpenStreetMap contributors, ODbL 1.0. https://osm.org/copyright",
      "osm_type":"way",
      "osm_id":574232767,
      "boundingbox":[
         "14.6529907",
         "14.6531146",
         "121.0340492",
         "121.0341783"
      ],
      "lat":"14.65305215",
      "lon":"121.034113797629",
      "display_name":"Starbucks, Bagong Pag-asa, 1st District, Quezon City, Metro Manila, 1100, Philippines",
      "class":"landuse",
      "type":"retail",
      "importance":0.30000000000000004
   },
   {
      "place_id":212390751,
      "licence":"Data © OpenStreetMap contributors, ODbL 1.0. https://osm.org/copyright",
      "osm_type":"way",
      "osm_id":653844914,
      "boundingbox":[
         "35.6887634",
         "35.689637",
         "-88.8645964",
         "-88.8639259"
      ],
      "lat":"35.68919695",
      "lon":"-88.8642631797254",
      "display_name":"Starbucks, Jackson, Madison County, Tennessee, USA",
      "class":"landuse",
      "type":"commercial",
      "importance":0.30000000000000004
   },
   {
      "place_id":220481158,
      "licence":"Data © OpenStreetMap contributors, ODbL 1.0. https://osm.org/copyright",
      "osm_type":"way",
      "osm_id":699403412,
      "boundingbox":[
         "54.1970215",
         "54.1975768",
         "-1.3640128",
         "-1.3628934"
      ],
      "lat":"54.19731615",
      "lon":"-1.36342356572266",
      "display_name":"Starbucks, Topcliffe, Hambleton, North Yorkshire, Yorkshire and the Humber, England, UK",
      "class":"landuse",
      "type":"construction",
      "importance":0.30000000000000004
   },
   {
      "place_id":209262468,
      "licence":"Data © OpenStreetMap contributors, ODbL 1.0. https://osm.org/copyright",
      "osm_type":"way",
      "osm_id":630629643,
      "boundingbox":[
         "45.5201776",
         "45.5206305",
         "-123.0495263",
         "-123.0491338"
      ],
      "lat":"45.5202415",
      "lon":"-123.0495263",
      "display_name":"starbucks, Cornelius, Washington County, Oregon, 97113-8912, USA",
      "class":"highway",
      "type":"service",
      "importance":0.185
   },
   {
      "place_id":203234991,
      "licence":"Data © OpenStreetMap contributors, ODbL 1.0. https://osm.org/copyright",
      "osm_type":"way",
      "osm_id":585748043,
      "boundingbox":[
         "42.5958064",
         "42.5960583",
         "-114.4537878",
         "-114.4531201"
      ],
      "lat":"42.5960328",
      "lon":"-114.4534149",
      "display_name":"Starbucks, Twin Falls, Twin Falls County, Idaho, 83303, USA",
      "class":"highway",
      "type":"service",
      "importance":0.175
   },
   {
      "place_id":199933003,
      "licence":"Data © OpenStreetMap contributors, ODbL 1.0. https://osm.org/copyright",
      "osm_type":"way",
      "osm_id":561682901,
      "boundingbox":[
         "40.141506",
         "40.14179",
         "-82.9883653",
         "-82.9878283"
      ],
      "lat":"40.141506",
      "lon":"-82.9880607",
      "display_name":"Starbucks, Polaris Towne Center, Columbus, Delaware County, Ohio, 43240, USA",
      "class":"highway",
      "type":"service",
      "importance":0.175
   },
   {
      "place_id":199922259,
      "licence":"Data © OpenStreetMap contributors, ODbL 1.0. https://osm.org/copyright",
      "osm_type":"way",
      "osm_id":561645620,
      "boundingbox":[
         "47.5957607",
         "47.5966273",
         "-122.6303493",
         "-122.6299422"
      ],
      "lat":"47.5961084",
      "lon":"-122.63003",
      "display_name":"Starbucks, Bremerton, Kitsap County, Washington, 98310, USA",
      "class":"highway",
      "type":"service",
      "importance":0.175
   },
   {
      "place_id":210703648,
      "licence":"Data © OpenStreetMap contributors, ODbL 1.0. https://osm.org/copyright",
      "osm_type":"way",
      "osm_id":641008084,
      "boundingbox":[
         "47.909268",
         "47.9098004",
         "-122.2255174",
         "-122.2254595"
      ],
      "lat":"47.909723",
      "lon":"-122.2255174",
      "display_name":"Starbucks, Intercity, Pinehurst, Everett, Snohomish County, Washington, 98204, USA",
      "class":"highway",
      "type":"service",
      "importance":0.175
   },
   {
      "place_id":180885231,
      "licence":"Data © OpenStreetMap contributors, ODbL 1.0. https://osm.org/copyright",
      "osm_type":"way",
      "osm_id":439064755,
      "boundingbox":[
         "38.592138",
         "38.5927772",
         "-90.5433536",
         "-90.5429724"
      ],
      "lat":"38.5927416",
      "lon":"-90.5431978",
      "display_name":"Starbucks, Olde Towne Plaza, Ballwin, Saint Louis County, Missouri, 63011, USA",
      "class":"highway",
      "type":"service",
      "importance":0.175
   },
   {
      "place_id":157893372,
      "licence":"Data © OpenStreetMap contributors, ODbL 1.0. https://osm.org/copyright",
      "osm_type":"way",
      "osm_id":318593592,
      "boundingbox":[
         "37.8254181",
         "37.8257484",
         "-121.2366731",
         "-121.2361599"
      ],
      "lat":"37.8254181",
      "lon":"-121.2361599",
      "display_name":"Starbucks, Manteca, San Joaquin County, California, 95336, USA",
      "class":"highway",
      "type":"service",
      "importance":0.175
   }
]

Either one of "q" or "q(Korean)" parameters should be used.