Bing Maps API
Bing Maps는 Microsoft의 지도 서비스입니다. search는 지도 중심 주변에서 키워드와 일치하는 업체를 찾아 업체별 이름, 주소, 좌표, 전화번호, 웹사이트, 카테고리, 영업 상태, 평점을 반환합니다.
원하는 지역의 latitude와 longitude를 지정합니다. 지정하지 않으면 Bing이 위치를 정합니다. 평점과 리뷰 수는 보통 Yelp나 TripAdvisor 같은 리뷰 사이트에서 가져오며, rating_source에 사이트명이 표시됩니다. page로 결과 페이지를 넘길 수 있으며 페이지당 최대 30개 업체가 반환됩니다.
플랫폼 가용성
- 24시간 상태
- 정상
최근 30일
제공 기능
각 Bing Maps 액션의 기능, 가격, 최근 24시간 상태를 확인할 수 있습니다. 액션을 열면 파라미터, 응답 필드, 코드 예제를 볼 수 있습니다.
| 기능 | 설명 | 1,000건당 | 24시간 상태 |
|---|---|---|---|
검색search | 지도 중심 주변에서 keyword에 해당하는 Bing Maps 업체를 찾습니다. | 요청 1,000개당 $0.56 | 정상 |
기능을 열면 파라미터, 응답 필드, 코드 샘플을 확인하고 직접 사용해 볼 수 있습니다.
Bing Maps 액션별로 어떤 입력을 받나요?
아래 각 답변은 호출 가능한 액션 하나와 실제 입력값을 짝지어 보여 줍니다. 파라미터의 의미와 허용 값은 액션마다 다릅니다. 익숙한 이름이라도 모든 플랫폼에서 같은 의미를 갖지는 않습니다.
공식 출처 링크는 옆에 있는 플랫폼 용어를 설명하기 위한 것입니다. 플랫폼의 승인이나 보증을 의미하지 않으며, 이 페이지에 명시되지 않은 공식 사이트의 기능은 EveryInfra API에 포함되지 않습니다.
| 액션 | 필수 | 선택 | 전달 방식 | 한도 | 1,000건당 | 응답 필드 |
|---|---|---|---|---|---|---|
search검색 지도 중심 주변에서 | keyword | language, latitude, longitude, page | Sync 응답 | 카탈로그 값: defaultLimit=20, maxLimit=30. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. | 요청 1,000개당 $0.56 | rank · place_id · name · url · category · address · lat · lng · phone · website · rating · rating_scale · review_count · rating_source · open_state · hours_text · image_url · platform |
Bing Maps search 파라미터는 각각 무엇을 의미하나요?
지도 중심 주변에서 keyword에 해당하는 Bing Maps 업체를 찾습니다. Bing 업체 ID, 주소, 좌표, 전화번호, 웹사이트, 카테고리, 영업 상태, Yelp나 TripAdvisor 같은 사이트의 평점과 리뷰 수를 가져옵니다. 페이지당 최대 30개 업체를 제공합니다.
keyword필수- 지도에서 찾을 대상으로, 업체 이름이나 카테고리를 입력합니다(예:
coffee,pizza). language선택- 반환할 업체 정보의 두 글자 언어 코드입니다(예:
en,de). latitude선택- 지도 중심의 위도로, -90~90 사이 값이며
longitude와 함께 지정합니다. 중심을 지정하지 않으면 Bing이 위치를 정하며, 원하는 도시가 아닐 수 있습니다.Microsoft Learn: Bing Maps Local Search는 위치 주변의 업체를 반환한다 — Microsoft 문서에 따르면 Bing Maps Local Search는 검색어와 함께 사용자 위치, 경계 상자, 원형 영역 중 하나를 받아 해당 위치 주변의 업체 엔터티를 반환합니다. 이 공식 인터페이스는 무료 계정에서는 지원이 종료되었으며 미국 업체만 다룹니다. 이 자료는 Bing Maps가 지도 위치로 업체를 찾는다는 점만 확인해 줍니다. 이 API의 `latitude`와 `longitude`는 EveryInfra가 정의한 지도 중심점으로, 해당 공식 인터페이스와는 별개이며 그 지역 제한도 적용되지 않습니다. · 확인일 longitude선택- 지도 중심의 경도로, -180~180 사이 값이며
latitude와 함께 지정합니다. page선택- 반환할 업체 목록 페이지로, 1부터 시작하며 페이지당 업체 수는
limit입니다(최대 20페이지).
Bing Maps API 사용 방법
- 01공개 카탈로그에서 플랫폼 액션을 선택합니다.
- 02플랫폼, 액션, 필수 파라미터를 POST /api/v1/social로 보냅니다.
- 03응답에서 결과를 읽습니다. 비동기 액션이면 반환된 작업 ID를 폴링합니다.
- 04애플리케이션에 필요한 응답 필드를 저장합니다.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"bing_maps","action":"search","params":{"keyword":"<keyword>"}}'
Bing Maps API 자주 묻는 질문
Bing Maps API로 무엇을 가져올 수 있나요?
platform을 bing_maps 값으로 설정하세요. 현재 카탈로그에 등록된 항목은 검색입니다. 각 액션 이름은 서로 다른 Bing Maps 객체나 뷰를 가리키며, 서로 바꿔 쓸 수 있는 검색 모드가 아닙니다.
Bing Maps search 요청에는 어떤 입력이 필요한가요?
지도에서 찾을 대상으로, 업체 이름이나 카테고리를 입력합니다(예: coffee, pizza). params 안의 keyword 필드로 전달하세요.
Bing Maps search 액션은 어떤 필드를 반환하나요?
선언된 스키마에 포함된 필드는 rank, place_id, name 및 category입니다. 선언된 필드라도 개별 레코드에는 없을 수 있으며, 다른 액션은 각각 고유한 필드 목록을 가집니다.
모든 Bing Maps 액션이 즉시 결과를 반환하나요?
비동기로 표시된 액션은 폴링할 작업 ID를 반환합니다. 그 밖의 모든 액션도 비동기로 실행할 수 있습니다. 요청 본문에 "mode": "async"를 추가하면 작업 ID를 즉시 받을 수 있어, 오래 걸리는 작업이나 조회 한도가 큰 요청에 유용합니다. 현재 카탈로그의 액션 구성은 sync 응답입니다.