Places API는 두 가지 API 버전을 지원합니다. Places API는 기존 API이고 Places API(신규)는 차세대 API 버전입니다.
Places API (신규)가 출시되면 가장 먼저 사용할 API 집합을 결정해야 합니다. 신규 고객이거나 이미 API를 사용 중인 기존 고객인 경우에도 마찬가지입니다. 이 가이드를 사용하여 두 API의 주요 차이점을 알아보세요.
API 목록
다음 표에는 두 API 세트가 모두 나와 있습니다. 기존 고객인 경우 이 표를 사용하여 현재 사용 중인 API를 대체하는 새 API를 확인하세요.
Places API | Places API(신규) | 참고 |
---|---|---|
Find Place | 텍스트 검색 (신규) | 장소 찾기의 새 버전은 없습니다. 텍스트 검색 (신규)로 대체되었습니다. |
Nearby Search | 주변 지역 검색 (신규) | 주변 검색 (신규)은 텍스트 입력을 지원하지 않으므로 텍스트 검색어가 포함된 기존 API를 사용하는 모든 요청은 텍스트 검색 (신규)를 사용해야 합니다. |
텍스트 검색 | 텍스트 검색 (신규) | |
장소 세부정보 | Place Details (신규) | |
장소 사진 | 장소 사진 (신규) | |
Place Autocomplete | 자동 완성 (신규) | |
검색어 자동 완성 | 자동 완성 (신규) | 자동 완성에 추가된 기능 (신규) |
API 키에서 사용 설정한 Places API 서비스 버전은 앱에서 사용하는 API를 제어합니다.
Places API: 기존 API를 사용 설정합니다. 앱에 사용된 API 키와 연결된 프로젝트에 Places API만 사용 설정된 경우 앱에서 새 API에 액세스할 수 없습니다.
Places API (신규): iOS용 Places SDK에 추가된 주요 기능 (신규)에 설명된 모든 새로운 API 및 기능을 사용 설정합니다. 앱에서 기존 API에 액세스할 수 없습니다.
둘 다: iOS용 Places SDK (신규) 및 iOS용 Places SDK의 모든 기능과 API를 사용 설정합니다.
Places API 서비스 선택에 대한 자세한 내용은 Google Cloud 프로젝트 설정을 참고하세요.
새 API로 이전
기존 API를 사용 중이며 새 API로 이전하려면 각 API의 다음 마이그레이션 가이드를 참고하세요.
Places API에 추가된 주요 기능 (신규)
이 섹션에서는 Places API (신규)에 추가된 주요 기능을 다룹니다.
Google Cloud 표준 플랫폼에서 구현됨
Places API (신규)는 Google Cloud의 서비스 인프라에 구현됩니다. 이 구현은 OAuth와 같은 향상된 보안 옵션으로 더 안전하고 신뢰할 수 있는 플랫폼을 제공합니다. 이 표준 API 디자인은 API 전체에서 어느 정도의 일관성을 제공하여 Places API (신규)를 통해 개발의 효율성을 높입니다.
성능 향상
Places API (신규)는 성능이 개선되어 기존 Places API를 사용하는 앱을 교체하는 것이 좋습니다.
간소화된 가격 책정
Places API (신규)를 사용하면 사용한 데이터에 대해서만 비용을 지불할 수 있도록 가격 책정이 간소화됩니다. 간소화된 가격 책정은 필드 마스크를 사용하여 구현됩니다.
Place Details (신규), Nearby Search (신규), Text Search (신규)에서는 필드 마스크를 사용하여 응답에서 반환할 필드 목록을 제어합니다. 그러면 요청된 데이터에 대해서만 요금이 청구됩니다. 필드 마스크를 사용하면 불필요한 데이터의 요청을 방지하여 불필요한 처리에 드는 시간과 요금을 막을 수 있습니다.
장소에 대한 일관된 응답 데이터
기존 API에서는 장소 세부정보, 주변 검색, 텍스트 검색 API가 장소에 대해 서로 다른 응답 데이터를 반환했습니다. Places API (신규)는 이러한 API가 모두 장소에 대해 동일한 데이터를 반환하도록 응답을 표준화합니다.
확장된 장소 유형
이제 API 응답에 장소의 기본 유형이 포함될 수 있습니다. 모든 장소에는 표 A에 나열된 대로 장소의 기본 유형으로 지정된 단일 유형 값이 있을 수 있습니다.
또한 새 API에는 아래 표에 표시된 장소 유형이 추가됩니다. 이러한 새 유형과 기존 유형을 Nearby Search (신규) 및 텍스트 검색 (신규)을 사용하여 검색할 수 있습니다. 새 유형은 모두 표 A에 포함되어 있습니다.
유형 | |||
---|---|---|---|
american_restaurant | discount_store | ice_cream_shop | sandwich_shop |
amusement_center | dog_park | indian_restaurant | school_district |
athletic_field | electric_vehicle_charging_station | indonesian_restaurant | seafood_restaurant |
auto_parts_store | event_venue | italian_restaurant | ski_resort |
banquet_hall | extended_stay_hotel | japanese_restaurant | spanish_restaurant |
barbecue_restaurant | 농장 | korean_restaurant | sporting_goods_store |
barber_shop | 팜스테이 | lebanese_restaurant | sports_club |
bed_and_breakfast | fast_food_restaurant | Marina | sports_complex |
brazilian_restaurant | ferry_terminal | 시장 | steak_house |
breakfast_restaurant | fitness_center | medical_lab | sushi_restaurant |
brunch_restaurant | french_restaurant | mediterranean_restaurant | swimming_pool |
bus_stop | gift_shop | mexican_restaurant | 맞춤 |
camping_cabin | golf_course | middle_eastern_restaurant | telecommunications_service_provider |
cell_phone_store | greek_restaurant | 모텔 | thai_restaurant |
child_care_agency | grocery_store | national_park | transit_depot |
chinese_restaurant | guest_house | park_and_ride | truck_stop |
coffee_shop | hair_salon | performing_arts_theater | turkish_restaurant |
community_center | hamburger_restaurant | pizza_restaurant | vegan_restaurant |
컨설턴트 | 헬리콥터 발착장 | 놀이터 | vegetarian_restaurant |
convention_center | hiking_area | 유치원 | vietnamese_restaurant |
오두막 | historical_landmark | private_guest_room | visitor_center |
courier_service | home_improvement_store | ramen_restaurant | wedding_venue |
cultural_center | 호스텔 | resort_hotel | 도매업체 |
dental_clinic | 호텔 | rest_stop |
이러한 새로운 유형과 함께 Places API (신규)는 다음 유형을 Places API의 표 2에서 Places API의 표 A (신규)로 이동했습니다. 즉, 이제 다음 유형을 검색의 일부로 사용할 수 있습니다.
country
administrative_area_level_1
administrative_area_level_2
postal_code
locality
동적 장소 데이터
Places API (신규)는 전기자동차 충전소의 이용 가능 여부 또는 주유소의 최신 연료 가격과 같은 동적 응답 데이터를 지원합니다. 이러한 응답 필드를 사용하여 동적 사용자 환경을 만드세요.
어떤 API를 선택해야 하나요?
앱 개발을 시작하려면 먼저 API를 선택해야 합니다.
Places API를 처음 시작한 신규 고객인 경우 새 API로 시작하세요.
신규 고객이며 아직 기존 API(예: Place Autocomplete 또는 Query Autocomplete)의 대체 API가 없는 경우 새 API와 기존 API를 조합하여 사용할 수 있습니다.
기존 고객인 경우 기존 API를 계속 사용할 수 있습니다. 하지만 Places API (신규)의 성능 개선 및 기능 향상을 활용하려면 새 API로 이전하면 됩니다.
이전에 관한 자세한 내용은 이전 개요를 참고하세요.