Places API는 다음 두 가지 API 버전을 지원합니다. Places API는 기존 API 및 Places API (신규) 생성됩니다
Places API (신규)가 출시됨에 따라 가장 먼저 해야 할 일은 사용할 API 집합입니다. 이는 신규 고객이든 기존 고객인 경우에도 마찬가지입니다. 이미 API를 사용 중인 고객입니다 이 가이드를 사용하여 주요 이해하기 차이점을 확인할 수 있습니다
API 목록
다음 표에는 두 가지 API 세트가 모두 나열되어 있습니다. 기존 고객은 이 표를 사용하여 사용 중인 API를 대체하는 새 API를 확인할 수 있습니다
| Places API | Places API(신규) | 참고 |
|---|---|---|
| Find Place | 텍스트 검색 (신규) | Find Place의 새로운 버전은 없습니다. 텍스트 검색 (신규)로 대체되었습니다. |
| 주변 검색 | 주변 검색 (신규) | 텍스트 쿼리가 포함된 기존 API를 사용하는 모든 요청은 텍스트 검색 (신규) 주변 검색 (신규)은 텍스트 입력을 지원하지 않기 때문입니다. |
| 텍스트 검색 | 텍스트 검색 (신규) | |
| 장소 세부정보 | Place Details (신규) | |
| 장소 사진 | 장소 사진 (신규) | |
| Place Autocomplete | 자동 완성 (신규) | |
| 쿼리 자동 완성 | 자동 완성 (신규) | 자동 완성에 추가된 기능 (신규) |
사용 설정하는 Places API 서비스의 버전 은 앱에서 사용하는 API를 제어합니다.
Places API: 기존 API를 사용 설정합니다. 만약 Places API가 앱에 사용된 API 키가 없으면 앱은 새 API에 액세스할 수 없습니다.
Places API (신규): 모든 새 API 및 앱에 추가된 주요 기능 iOS용 Places SDK (신규). 이 앱은 기존 API에 액세스할 수 있습니다
둘 다: 두 언어 모두 모든 기능과 API를 사용 설정합니다. iOS용 Places SDK (신규) iOS용 Places SDK.
Places API 서비스 선택에 대한 자세한 내용은 Google Cloud 프로젝트 설정을 참조하세요.
새 API로 이전
기존 API를 사용 중이며 새 API로 마이그레이션하려는 경우 각 API에 대한 다음 이전 가이드를 참고하세요.
Places API에 추가된 주요 기능 (신규)
이 섹션에서는 Places API (신규)에 추가된 주요 기능을 다룹니다.
Google Cloud 표준 플랫폼에서 구현됨
Places API (신규)는 서비스 인프라 살펴봤습니다 이 구현은 보다 안전하고 신뢰할 수 있는 향상된 보안 옵션을 갖춘 플랫폼 OAuth를 수행합니다. 이 표준 API는 설계는 API 전체에서 일관성의 수준을 높여 효율성을 개선합니다. 개발 과정 중 한 가지였습니다 (신규).
성능 향상
Places API (신규)는 향상된 성능을 제공합니다. 기존 Places API를 사용하는 앱을 대체할 만한 가치가 있습니다.
간소화된 가격 책정
Places API (신규)를 사용하면 가격이 간소화되므로 사용한 데이터에 대한 비용을 지불할 수 있습니다. 간소화된 가격 책정은 필드 마스크.
장소 세부정보 (신규)를 사용하면 주변 검색 (신규) 및 텍스트 검색 (신규)은 필드 마스크를 사용하여 응답에서 반환할 필드의 목록입니다. 그러면 해당 데이터에 대한 요금만 청구됨 있습니다. 필드 마스킹을 사용하면 불필요한 데이터를 요청하지 않으므로 불필요한 처리 시간을 피할 수 있습니다. 확인할 수 있습니다
장소에 대한 일관된 응답 데이터
기존 API인 장소 세부정보에서는 주변 검색, 텍스트 검색 API가 장소에 대해 다른 응답 데이터를 반환했습니다. Places API (신규) 는 응답을 표준화하여 이러한 API가 모두 장소에 대해 동일한 데이터를 반환하도록 합니다.
확장된 장소 유형
이제 API 응답이 장소의 기본 유형을 포함할 수 있습니다. 모든 장소에는 장소에 나열된 대로 장소의 기본 유형으로 지정된 단일 유형 값 표 A.
또한 새 API는 아래 표에 표시된 장소 유형을 추가합니다. 다음과 같은 작업을 할 수 있습니다. 를 사용하여 검색에서 새 유형과 기존 유형을 주변 검색 (신규) 및 텍스트 검색 (신규) 새로운 유형은 표 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 (신규)로의 변경을 수행합니다. 즉, 이제 이러한 유형을 검색:
countryadministrative_area_level_1administrative_area_level_2postal_codelocality
동적 장소 데이터
Places API (신규)는 예약 가능 여부 등의 동적 응답 데이터를 지원합니다. 정보를 제공할 수 있습니다. 사용 사용하여 동적 사용자 환경을 만들 수 있습니다.
어떤 API를 선택해야 할까요?
앱 개발을 시작하려면 먼저 API를 선택해야 합니다.
Places API를 처음 시작하는 신규 고객인 경우 새 API로 시작합니다
신규 고객이며 아직 교체 기기가 없는 경우 기존 API(예: Place Autocomplete 또는 Query) 자동 완성을 사용하면 새 API와 기존 API를 조합하여 사용할 수 있습니다.
기존 고객인 경우 기존 API에 액세스할 수 있습니다 하지만 향상된 성능과 기능 향상에 대해 좀 더 알게 되었으니 새로운 API를 제공합니다
이전에 대한 자세한 내용은 이전을 참조하세요. 개요를 참조하세요.