Spot API : Search spots by name or address

GET /api/1/places/search.json

mode が "name" の場合名前で検索、 "address" の場合住所で検索を行う。 空白文字列を含んだ場合、前後の単語でのAND検索となる。 作成日時が新しい順になっている。

Parameters

Key Value デフォルト値
page 取得するページ番号。1 <= page 1
limit 1ページに含む要素の数。 1 <= limit <= 100 100
q 検索する文字列
mode "name" or "address"

Request

Route

GET /api/1/places/search.json?q=%E9%A0%93%E6%99%BA+%E3%82%AA%E3%83%95%E3%82%A3%E3%82%B9&mode=name&limit=10&page=1

Headers

Host: example.org
Cookie: 
Origin:

Query Parameters

q: 頓智 オフィス
mode: name
limit: 10
page: 1

Response

Headers

Content-Type: application/json; charset=utf-8
Set-Cookie: guest_distinct_id=b638f39b-a653-422c-9cc9-0ce3b2a644f1; expires=Mon, 09-Jan-2023 01:54:15 GMT
THIS_IS_SESSION_COOKIE_KEY_FOR_SPEC=BAh7B0kiD3Nlc3Npb25faWQGOgZFRkkiJWM3MjU4MDdhMGVlM2UzZTc2OTlkODJkMWNlODg5ZjE2BjsAVEkiGGtwaV9wcmV2X2NvbnRyb2xsZXIGOwBGSSIWYXBpL3BsYWNlcyNzZWFyY2gGOwBG--d334f4d233ad5c9d79666d536ca744464a3f7a37; path=/; HttpOnly
X-Ua-Compatible: IE=Edge,chrome=1
E-Tag: "01bb76bec9b72585c1597333868ac7cc"
Cache-Control: max-age=0, private, must-revalidate
X-Request: efa11c5055d6e38df3e2fafe0498401e
X-Runtime: 0.016269
Content-Length: 310

Status

200 OK

Body

フォーマット: places/paginated_list
{
  "total": 1,
  "page": 1,
  "limit": 10,
  "places": [
    {
      "id": 47930264,
      "name": "頓智・オフィス",
      "address": "東京都新宿区新宿2-5-12",
      "description": "株式会社頓智ドット\n新宿御苑の近く",
      "lon": 139.707314372,
      "lat": 35.689448168,
      "created_at": "2013-01-09T01:54:04Z",
      "updated_at": "2013-01-09T01:54:04Z"
    }
  ]
}