Wednesday, August 14, 2013

Places API released

For the technically inclined sQuidders out there, we have just released a new Places API which allows you to retrieve all marinas, anchorages and other sQuidd.io places based on lat/lon coordinates from our database of over 10,000 boating destinations of interest worldwide. The API may be useful if you are creating geo-based applications such as marine charts and cruising guides. The results you get by using this particular API  call are the same you would obtain by searching for places through web UI, only in machine readable format.

The use of the API requires a sQuidd.io Business Account. If you have not yet signed up for one you can do so  at http://squidd.io/accounts/new. Business Accounts are free. Our APIs are REST-ful, and all responses are in JSON format. The basic request for a list of sQuidd.io Places looks like this:

http://squidd.io/places/?api_key=2CJ4ZIFWLPkuVitGs&latitude=37.589&longitude=-122.317&frame_size=1000

  • api_key: the API key associated with your business account. To obtain your key, go to your Account/Contact Info view and look for the value at the bottom of the form. 

  • latitude/longitude: the coordinates for the center of the search, in decimal format (south and east are negative numbers). 
  • frame_size: the half size of an approximate square centered on your lat/lon position, in meters. For instance, if you ar searching for all marinas and anchorages in the San Francisco Bay Area (latitude = 37.589, longitude=-122.317) with a frame_size of 1000, the results will include all places located in an area extending 1 Km north, 1 Km south, 1Km east and 1km West of  the specified coordinates. The maximum allowed value is 10,000.
And here is an example of the JSON response that this request would generate:

[
  {
    "address": "385 Oyster Point Blvd # 8A",
    "address2": null,
    "ais_unique_visitors": null,
    "city": "S San Francisco",
    "country_code": "US",
    "elevation": 6.615729808807373,
    "id": 1496,
    "latitude": 37.66389846801758,
    "longitude": -122.38500213623047,
    "name": "Oyster Cove Marina",
    "place_type": "Marina",
    "postal_code": "94080",
    "squiddio_url": "http://192.168.1.155:3000/places/1496",
    "state_code": "CA",
    "timezone": "America/Los_Angeles"
  },
  {
    "address": "400 Sierra Point Parkway",
    "address2": null,
    "ais_unique_visitors": null,
    "city": "Brisbane",
    "country_code": "US",
    "elevation": 5.1478800773620605,
    "id": 1493,
    "latitude": 37.673301696777344,
    "longitude": -122.37999725341797,
    "name": "City of Brisbane: Brisbane Marina",
    "place_type": "Marina",
    "postal_code": "94005",
    "squiddio_url": "http://192.168.1.155:3000/places/1493",
    "state_code": "CA",
    "timezone": "America/Los_Angeles"
  }
]

2 comments:

  1. Thanks for sharing, nice post!
    - Máy đưa võng tự động hay thiet bi dua vong tu dong ngày càng trở thành 1 phần của các gia đình Việt. Máy đưa võng hay vong dua tu dong cho em be đang chiếm được cảm tình của đông đảo người tiêu dùng bởi tính tiện dụng và lợi ích nhân văn của vong tu dong em be, những lợi ích mà may dua vong tu dong mang lại là vô củng thiết thực.
    - Với nhãn hiệu uy tín, sản phẩm máy đưa võng tự động chất lượng và gia may dua vong phải chăng, máy đưa võng tự động An Thái Sơn tự hào là địa chỉ bán máy đưa võng em bé tốt nhất, uy tín nhất cho bé.
    Chia sẽ các bạn giup tre tang can nhanh cho bé, nguyên nhân và cách trị chứng mất ngủ ở trẻ em hiệu quả hay mách mẹ bí quyết cải thiện làn da cho bé hiệu quả nhất, chia sẻ bí quyết giúp bé ngủ ngon giấc hay tìm hiểu về đông trùng hạ thảo và những cách chế biến đông trùng hạ thảo nguyên con, chia sẻ các mẹ nguyên nhân và cách chữa trị bệnh rụng tóc ở trẻ em hiệu quả, những cách chống nắng cho bé hiệu quả trong những ngày hè hay thực phẩm giúp giải độc gan cho bạn, thực phẩm thiên nhiên giúp nhanh liền sẹo hiệu quả, cách phòng trị bệnh viêm khớp ở trẻ em an toàn, những thực phẩm bổ não cho trẻ giúp cải thiện trí nhớ, những thực phẩm không nên ăn khi thiếu máu não bạn nên lưu ý, chia sẻ thực phẩm cho người bị rối loạn tiền đình hay người bị bệnh mất ngủ nên ăn gì hoặc món ăn chữa bệnh mất ngủ cực hiệu quả!
    Những thực phẩm giúp đẹp da tại http://nhungthucphamgiupda.blogspot.com/
    Thực phẩm giúp bạn trẻ đẹp tại http://thucphamgiuptre.blogspot.com/
    Thực phẩm làm tăng tại http://thucphamlamtang.blogspot.com/
    Những thực phẩm giúp làm giảm tại http://thucphamlamgiam.blogspot.com/

    ReplyDelete
  2. We hope that our knowledge can be of worth to you when looking for model new} journey at a top-rated and reliable on-line on line casino. Combined with the widespread adoption of smartphone expertise, many are keen to gamble on the go and throughout the day. There has never been a greater time to start out|to begin} an online on line casino enterprise. Ensure you 1xbet only use a on line casino website that is licensed by the UK playing fee.

    ReplyDelete