Apple Maps API
Apple Maps는 Apple 기기에 기본 탑재된 지도 서비스입니다. places는 숫자형 Apple Maps ID로 한 번에 최대 50곳의 장소를 조회하며, 장소별 주소, 좌표, 전화번호, 웹사이트, 카테고리, 주간 영업시간, 편의시설, 사진, 평점 정보를 반환합니다.
장소 ID는 DuckDuckGo Maps 결과의 apple_maps_id 열이나 Apple Maps 공유 링크의 auid에서 얻을 수 있습니다. Apple Maps에 표시되는 평점은 제휴 리뷰 사이트에서 가져온 경우가 많아, 각 행의 rating_source에 해당 사이트가 표시됩니다. 호출 비용은 ID가 하나든 50개든 같습니다.
플랫폼 가용성
- 24시간 상태
- 정상
최근 30일
제공 기능
각 Apple Maps 액션의 기능, 가격, 최근 24시간 상태를 확인할 수 있습니다. 액션을 열면 파라미터, 응답 필드, 코드 예제를 볼 수 있습니다.
| 기능 | 설명 | 1,000건당 | 24시간 상태 |
|---|---|---|---|
장소 상세 정보places | 숫자 ID로 Apple Maps 장소를 호출 한 번에 최대 50개까지 조회합니다. | 요청 1,000개당 $0.56 | 정상 |
기능을 열면 파라미터, 응답 필드, 코드 샘플을 확인하고 직접 사용해 볼 수 있습니다.
Apple Maps 액션별로 어떤 입력을 받나요?
아래 각 답변은 호출 가능한 액션 하나와 실제 입력값을 짝지어 보여 줍니다. 파라미터의 의미와 허용 값은 액션마다 다릅니다. 익숙한 이름이라도 모든 플랫폼에서 같은 의미를 갖지는 않습니다.
공식 출처 링크는 옆에 있는 플랫폼 용어를 설명하기 위한 것입니다. 플랫폼의 승인이나 보증을 의미하지 않으며, 이 페이지에 명시되지 않은 공식 사이트의 기능은 EveryInfra API에 포함되지 않습니다.
| 액션 | 필수 | 선택 | 전달 방식 | 한도 | 1,000건당 | 응답 필드 |
|---|---|---|---|---|---|---|
places장소 상세 정보 숫자 ID로 Apple Maps 장소를 호출 한 번에 최대 50개까지 조회합니다. 각 행에는 주소, 좌표, 전화번호, 웹사이트, 카테고리, 주간 영업시간, 편의 시설, 사진, 가격대, 평점과 그 출처 사이트, 대표 리뷰 몇 개가 포함됩니다. ID는 DuckDuckGo Maps 결과나 Apple Maps 링크에서 얻을 수 있으며, 호출 비용은 ID가 1개든 50개든 같습니다. | place_ids | language | Sync 응답 | — | 요청 1,000개당 $0.56 | place_id · name · url · category · categories · address · city · state · postal_code · country_code · lat · lng · timezone · phone · website · rating · rating_scale · review_count · rating_source · price · open_state · opening_hours · amenities · image_urls · top_reviews · is_claimed · platform |
Apple Maps places 파라미터는 각각 무엇을 의미하나요?
숫자 ID로 Apple Maps 장소를 호출 한 번에 최대 50개까지 조회합니다. 각 행에는 주소, 좌표, 전화번호, 웹사이트, 카테고리, 주간 영업시간, 편의 시설, 사진, 가격대, 평점과 그 출처 사이트, 대표 리뷰 몇 개가 포함됩니다. ID는 DuckDuckGo Maps 결과나 Apple Maps 링크에서 얻을 수 있으며, 호출 비용은 ID가 1개든 50개든 같습니다.
전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태place_ids필수- 숫자형 Apple Maps 장소 ID 1~50개의 목록입니다(예:
["12971322601039101590"]). DuckDuckGo Maps 행의apple_maps_id또는 Apple Maps 링크의auid에서 가져옵니다. 호출 비용은 ID가 1개든 50개든 같으며, 숫자가 아닌 ID는 과금 전에 거부됩니다.Apple 개발자 문서: Place ID로 고유한 장소 식별하기 — Apple 개발자 문서에 따르면 Place ID는 관심 장소가 존재하는 동안 같은 장소를 계속 식별하며, 해당 장소의 정보를 가져오는 데 쓸 수 있습니다. 이 자료는 Apple Maps의 장소에 고정된 고유 ID가 있다는 점만 확인해 줍니다. 이 API의 `place_ids`는 Apple Maps 링크에 있는 숫자로만 된 장소 ID(auid)로, MapKit의 영숫자 Place ID와 표기 방식이 달라 서로 바꿔 쓸 수 없습니다. 이 자료는 영업시간, 편의시설, 평점 필드는 다루지 않습니다. · 확인일 language선택- 반환할 장소 상세 정보의 언어입니다(예:
en-US,zh-CN,ja-JP).en같은 두 글자 코드도 사용할 수 있습니다. 기본값은en-US입니다.
Apple 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":"apple_maps","action":"places","params":{"place_ids":"<place_ids>"}}'
Apple Maps API 자주 묻는 질문
Apple Maps API로 무엇을 가져올 수 있나요?
platform을 apple_maps 값으로 설정하세요. 현재 카탈로그에 등록된 항목은 장소 상세 정보입니다. 각 액션 이름은 서로 다른 Apple Maps 객체나 뷰를 가리키며, 서로 바꿔 쓸 수 있는 검색 모드가 아닙니다.
Apple Maps places 요청에는 어떤 입력이 필요한가요?
숫자형 Apple Maps 장소 ID 1~50개의 목록입니다(예: ["12971322601039101590"]). DuckDuckGo Maps 행의 apple_maps_id 또는 Apple Maps 링크의 auid에서 가져옵니다. 호출 비용은 ID가 1개든 50개든 같으며, 숫자가 아닌 ID는 과금 전에 거부됩니다. params 안의 place_ids 필드로 전달하세요.
Apple Maps places 액션은 어떤 필드를 반환하나요?
선언된 스키마에 포함된 필드는 place_id, name, category 및 categories입니다. 선언된 필드라도 개별 레코드에는 없을 수 있으며, 다른 액션은 각각 고유한 필드 목록을 가집니다.
모든 Apple Maps 액션이 즉시 결과를 반환하나요?
비동기로 표시된 액션은 폴링할 작업 ID를 반환합니다. 그 밖의 모든 액션도 비동기로 실행할 수 있습니다. 요청 본문에 "mode": "async"를 추가하면 작업 ID를 즉시 받을 수 있어, 오래 걸리는 작업이나 조회 한도가 큰 요청에 유용합니다. 현재 카탈로그의 액션 구성은 sync 응답입니다.