Forsquare의 Place API에 대해 비용과 제한을 조사했다

27249 단어 foursquaretech
API 버전 V2의 내용입니다.
여기 있습니다.
https://developer.foursquare.com/docs/places-api/
단어로 위치정보(시설명, 주소, 위도경도,Forsquare 측에서 준비한 분류 등),venue 검색id(Forsquare에서 유일하게 위치 정보를 식별할 수 있음)에서 이 위치의 상세한 데이터와 다양한 API를 얻을 수 있습니다.
OAuth를 이용한 사용자 인증 등도 가능하지만, 이번엔 그 외의 것들에 관해 쓴다.

실제적인 응답


구체적으로 어떤 데이터를 얻을 수 있는지 보여주는 게 이해가 잘 될 것 같아요.
예를 들어, 문자https://api.foursquare.com/v2/venues/suggestcompletion를 입력하면 API가 문자와 비슷한 위치의 이름을 표시합니다.zepp 검색 후 다음과 같은 응답을 받았습니다.
{
  "meta": {
    "code": 200,
    "requestId": "61355798e91a0e64f5d65415"
  },
  "response": {
    "minivenues": [
      {
        "id": "5e1eda53c0a0b20008509ec2",
        "name": "KT Zepp Yokohama",
        "location": {
          "address": "西区みなとみらい4-3-6",
          "city": "横浜市",
          "state": "神奈川県",
          "postalCode": "220-0012",
          "country": "JP",
          "lat": 35.46001198513382,
          "lng": 139.62596997113488
        },
        "categories": [
          {
            "id": "4bf58dd8d48988d1e9931735",
            "name": "ライブハウス",
            "pluralName": "ライブハウス",
            "shortName": "ライブハウス",
            "icon": {
              "prefix": "https:\/\/ss3.4sqi.net\/img\/categories_v2\/arts_entertainment\/musicvenue_rockclub_",
              "suffix": ".png"
            },
            "primary": true
          },
          {
            "id": "5032792091d4c4b30a586d5c",
            "name": "コンサートホール",
            "pluralName": "コンサートホール",
            "shortName": "コンサートホール",
            "icon": {
              "prefix": "https:\/\/ss3.4sqi.net\/img\/categories_v2\/arts_entertainment\/musicvenue_",
              "suffix": ".png"
            }
          },
          {
            "id": "4d4b7104d754a06370d81259",
            "name": "芸術 & 娯楽",
            "pluralName": "芸術 & 娯楽",
            "shortName": "芸術 & 娯楽",
            "icon": {
              "prefix": "https:\/\/ss3.4sqi.net\/img\/categories_v2\/arts_entertainment\/default_",
              "suffix": ".png"
            }
          },
          {
            "id": "4bf58dd8d48988d1e5931735",
            "name": "音楽関係",
            "pluralName": "音楽関係",
            "shortName": "音楽関係",
            "icon": {
              "prefix": "https:\/\/ss3.4sqi.net\/img\/categories_v2\/arts_entertainment\/musicvenue_",
              "suffix": ".png"
            }
          }
        ]
      },
      {
        "id": "4bac1684f964a5207be33ae3",
        "name": "Zepp Tokyo",
        "location": {
          "address": "青海1-3-11",
          "city": "江東区",
          "state": "東京都",
          "postalCode": "135-0064",
          "country": "JP",
          "lat": 35.625867721406706,
          "lng": 139.7815854065503
        },
        "categories": [
          {
            "id": "4bf58dd8d48988d1e9931735",
            "name": "ライブハウス",
            "pluralName": "ライブハウス",
            "shortName": "ライブハウス",
            "icon": {
              "prefix": "https:\/\/ss3.4sqi.net\/img\/categories_v2\/arts_entertainment\/musicvenue_rockclub_",
              "suffix": ".png"
            },
            "primary": true
          },
          {
            "id": "4d4b7104d754a06370d81259",
            "name": "芸術 & 娯楽",
            "pluralName": "芸術 & 娯楽",
            "shortName": "芸術 & 娯楽",
            "icon": {
              "prefix": "https:\/\/ss3.4sqi.net\/img\/categories_v2\/arts_entertainment\/default_",
              "suffix": ".png"
            }
          },
          {
            "id": "4bf58dd8d48988d1e5931735",
            "name": "音楽関係",
            "pluralName": "音楽関係",
            "shortName": "音楽関係",
            "icon": {
              "prefix": "https:\/\/ss3.4sqi.net\/img\/categories_v2\/arts_entertainment\/musicvenue_",
              "suffix": ".png"
            }
          }
        ]
      },
      {
        "id": "5effddb3f8f3552c73a31803",
        "name": "Zepp Haneda",
        "location": {
          "address": "羽田空港1-1-4",
          "crossStreet": "HANEDA INNOVATION CITY ZONE H",
          "city": "大田区",
          "state": "東京都",
          "postalCode": "144-0041",
          "country": "JP",
          "lat": 35.547375,
          "lng": 139.75687
        },
        "categories": [
          {
            "id": "4bf58dd8d48988d1e9931735",
            "name": "ライブハウス",
            "pluralName": "ライブハウス",
            "shortName": "ライブハウス",
            "icon": {
              "prefix": "https:\/\/ss3.4sqi.net\/img\/categories_v2\/arts_entertainment\/musicvenue_rockclub_",
              "suffix": ".png"
            },
            "primary": true
          },
          {
            "id": "4d4b7104d754a06370d81259",
            "name": "芸術 & 娯楽",
            "pluralName": "芸術 & 娯楽",
            "shortName": "芸術 & 娯楽",
            "icon": {
              "prefix": "https:\/\/ss3.4sqi.net\/img\/categories_v2\/arts_entertainment\/default_",
              "suffix": ".png"
            }
          },
          {
            "id": "4bf58dd8d48988d1e5931735",
            "name": "音楽関係",
            "pluralName": "音楽関係",
            "shortName": "音楽関係",
            "icon": {
              "prefix": "https:\/\/ss3.4sqi.net\/img\/categories_v2\/arts_entertainment\/musicvenue_",
              "suffix": ".png"
            }
          }
        ]
      },
      // 以下省略
    ]
  }
}

끝점


https://developer.foursquare.com/docs/places-api/endpoints/
리글라 API와 프리미엄 API 두 종류로 나뉘어 약 40개의 엔드포인트를 준비했다.
두 가지는 하루 이용 횟수 등의 제한에 따라 요금을 계산해 사용하는 비용이 다르다.
예를 들어, 검색 시스템은 일반적으로 API이지만 ID를 지정하여 자세한 위치를 가져오는 API는 고급입니다.더 풍부한 정보를 얻을 수 있다는 것이 프리미엄 API의 느낌이다.

비용


https://developer.foursquare.com/docs/places-api/getting-started/#choose-your-account-tier
계획에는 세 가지가 있다.

자유 계획


무료.

시작 계획


$599/월 + 이하의 계량 요금
$0.001/Regular Call
$0.06/Premium Call

기업 계획


Contact us

제한


각 계획에 어떤 제약이 있는지 말씀드리자면요.

자유 계획


https://developer.foursquare.com/docs/places-api/rate-limits/
Reglar Call 99500회/일
Premium Call 500회/일
venues/의 종점 5000회/시간에 비해
다른 엔드포인트의 경우 시간당 500회
요청 2개/1초

시작 계획


문서로 명확하게 기재되지는 않았지만
https://developer.foursquare.com/docs/places-api/rate-limits/의 이미지에 따르면2X More QPS, Venue Photos & Tips요청/초 4개
그 외에 다른 제한은 없을 것으로 추정된다.

기업 계획


https://docs.foursquare.com/docs/usage-guidelines
100개 요청/초
그 외에는 명확한 제한이 없을 것으로 추정된다.

캐시


얻은 정보는 DB 등에 저장할 수 있습니까?관하여

무료 방안


https://developer.foursquare.com/docs/usage-guidelines/#data-retention
제한 없이 id를 저장할 수 있습니다.
기타 정보는 24시간 저장할 수 있다.

시작 계획


없음
공짜 방안과 같다고 생각하면
제한 없이 id를 저장할 수 있습니다.
기타 정보는 24시간 저장할 수 있다.

기업 계획


https://docs.foursquare.com/docs/usage-guidelines#data-retention
제한 없이 id를 저장할 수 있습니다.
얻은 정보는 30일 동안 보관할 수 있다.

끝맺다


무료, 시작 계획 데이터의 유지 기간은 24시간이며, 실제 사용하면 대량 등 정기적인 업데이트가 필요하다.
API라고 부르는 빈도가 적으면 DB에 저장하지 않아도 매번 API를 두드릴 수 있다.

좋은 웹페이지 즐겨찾기