FATOS Map Developers (Powered by NostraMap)
Developer SiteConsole
  • FATOS Developer Introduction
  • FATOS API
    • Map
      • Map control
        • Building
        • Bounds
        • Center
        • Heading
        • Flyto
        • Tilt
        • Zoom
        • Marker
          • Instance Members
        • Polyline
        • Polygon
        • Circle
        • On/Off
        • Once
        • Language
        • Theme
        • Cluster
          • Instance Members
      • Button control
      • Utilities
        • Rectangle
        • Distance
        • Area
    • Search
      • POI
      • Address
      • Geocoding
        • Forward
        • Reverse
      • Geofencing
    • Routing
      • Route
      • Route for truck
    • Advanced
      • Logistics
  • FATOS SDK
    • Authentication
    • Platform
      • Android
        • Start
        • Component
      • iOS
        • Start
        • Component
      • React Native
        • Start
        • Component
  • Release note
    • FATOS Map API
    • API Server
    • RP Server
  • Get your API Key
  • Troubleshooting
    • FAQ
Powered by GitBook
On this page

Was this helpful?

  1. FATOS API
  2. Search
  3. Geocoding

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....)


[
   {
      "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.

PreviousGeocodingNextReverse

Last updated 4 years ago

Was this helpful?