Places API iki API sürümünü destekler: Places API, mevcut API'ler, Places API (Yeni) ise API'lerin yeni nesil sürümüdür.
Places API'nin (Yeni) kullanıma sunulmasıyla birlikte ilk göreviniz, hangi API grubunun kullanılacağına karar vermektir. Bu durum, yeni bir müşteri veya zaten API'leri kullanan mevcut bir müşteriyseniz geçerlidir. İki API arasındaki temel farkları anlamak için bu kılavuzu kullanın.
API listesi
Aşağıdaki tabloda her iki API grubu da listelenmiştir. Mevcut bir müşteriyseniz şu anda kullandığınız bir API'nin yerini alacak yeni API'yi belirlemek için bu tablodan yararlanın.
| Places API | Places API (Yeni) | Not |
|---|---|---|
| Yer Bulma | Metin Arama (Yeni) | Yer Bulma uygulamasının yeni bir sürümü yok. Bunun yerini Metin Arama (Yeni) aldı. |
| Yakında Arama | Yakında Arama (Yeni) | Yakınlarda Arama (Yeni) metin girişini desteklemediğinden metin sorgusu içeren mevcut API'yi kullanan tüm istekler Metin Arama (Yeni) özelliğini kullanmalıdır. |
| Metin Arama | Metin Arama (Yeni) | |
| Yer Ayrıntıları | Yer Ayrıntıları (Yeni) | |
| Yer Fotoğrafı | Yer Fotoğrafı (Yeni) | |
| Otomatik Yer Tamamlama | Otomatik tamamlama (Yeni) | |
| Sorgu Otomatik Tamamlama | Otomatik tamamlama (Yeni) | Otomatik tamamlamaya özellikler eklendi (Yeni) |
API anahtarınızda etkinleştirdiğiniz Places API hizmetinin sürümü, uygulamanızın kullandığı API'leri kontrol eder:
Places API: Mevcut API'leri etkinleştirir. Yalnızca uygulamanız için kullanılan API anahtarıyla ilişkilendirilmiş proje için Places API etkinleştirilirse uygulamanız yeni API'lere erişemez.
Places API (Yeni): iOS için Yerler SDK'sına eklenen temel özellikler (Yeni) bölümünde açıklanan tüm yeni API'leri ve özellikleri etkinleştirir. Uygulamanız mevcut API'lere erişemez.
Her ikisi: Hem iOS için Yerler SDK'sı (Yeni) hem de iOS için Yerler SDK'sı için tüm özellikleri ve API'leri etkinleştirir.
Places API hizmetini seçme hakkında daha fazla bilgi için Google Cloud projenizi ayarlama bölümüne bakın.
Yeni API'lere geçiş yapın
Mevcut bir API'yi kullanıyor ve yeni API'ye geçmek istiyorsanız her API için aşağıdaki taşıma rehberlerini inceleyin:
- Yakındaki Arama'ya Taşıma (Yeni)
- Metin Arama'ya Taşıma (Yeni)
- Yer Ayrıntılarına Taşıma (Yeni)
- Yer Fotoğrafına Taşıma (Yeni)
- Otomatik tamamlamaya taşıma (Yeni)
Places API'ye eklenen önemli özellikler (Yeni)
Bu bölümde, Places API'ye (Yeni) eklenen temel özellikler ele alınmaktadır.
Google Cloud standart platformunda uygulanır
Places API (Yeni), Google Cloud'daki hizmet altyapısında uygulandı. Bu uygulama, OAuth gibi gelişmiş güvenlik seçenekleri içeren daha güvenli ve güvenilir bir platform sunar. Bu standart API tasarımı, Places API (Yeni) ile geliştirme verimliliğini artıran API'ler genelinde bir tutarlılık düzeyi sağlar.
Artırılmış performans
Places API (Yeni) daha iyi performans sağladığı için mevcut Places API'yi kullanan uygulamaları değiştirmek faydalı olacaktır.
Basitleştirilmiş fiyatlandırma
Places API (Yeni) ile fiyatlandırma basitleştirildi. Böylece yalnızca kullandığınız veriler için ödeme yaparsınız. Basitleştirilmiş fiyatlandırma, alan maskesi kullanılarak uygulanır.
Yer Ayrıntıları (Yeni), Yakındaki Arama (Yeni) ve Metin Arama (Yeni) ile, yanıtta döndürülecek alanların listesini kontrol etmek için alan maskesini kullanırsınız. Bu durumda yalnızca istenen veriler için faturalandırılırsınız. Alan maskelemenin kullanılması, gereksiz veri isteğinde bulunmadığınızdan emin olmak için iyi bir tasarım uygulamasıdır. Bu da gereksiz işleme süresi ve faturalandırma ücretlerinin önlenmesine yardımcı olur.
Bir yer için tutarlı yanıt verileri
Mevcut API'lerle Yer Ayrıntıları, Yakında Arama ve Metin Arama API'leri bir yer için farklı yanıt verileri döndürdü. Places API (Yeni) seçeneği, yanıtı standart hale getirerek bu API'lerin bir yer için aynı verileri döndürmesini sağlar.
Genişletilmiş yer türleri
API yanıtı artık bir yerin birincil türünü içerebilir. Her yerin, Tablo A'da listelendiği gibi, yerin birincil türü olarak belirtilen tek bir türü olabilir.
Ayrıca yeni API, aşağıdaki tabloda gösterilen yer türlerini de ekler. Bu yeni türleri ve mevcut türleri, Yakındaki Arama (Yeni) ve Metin Arama (Yeni) ile arama yaparken kullanabilirsiniz. Yeni türlerin tümü Tablo A'ya dahil edilmiştir.
| Tür | |||
|---|---|---|---|
| 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 | çiftlik | korean_restaurant | sporting_goods_store |
| barber_shop | çiftlik konaklaması | lebanese_restaurant | sports_club |
| bed_and_breakfast | fast_food_restaurant | Marina | sports_complex |
| brazilian_restaurant | ferry_terminal | market | steak_house |
| breakfast_restaurant | fitness_center | medical_lab | sushi_restaurant |
| brunch_restaurant | french_restaurant | mediterranean_restaurant | swimming_pool |
| bus_stop | gift_shop | mexican_restaurant | uyarlamak |
| camping_cabin | golf_course | middle_eastern_restaurant | telecommunications_service_provider |
| cell_phone_store | greek_restaurant | motel | 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 |
| danışman | heliport | playground | vegetarian_restaurant |
| convention_center | hiking_area | okul öncesi kurum | vietnamese_restaurant |
| kır evi | historical_landmark | private_guest_room | visitor_center |
| courier_service | home_improvement_store | ramen_restaurant | wedding_venue |
| cultural_center | pansiyon | resort_hotel | toptancı |
| dental_clinic | otel | rest_stop |
Places API (Yeni), bu yeni türlerle birlikte aşağıdaki türleri Places API için Tablo 2'den Places API için A Tablosuna (Yeni) taşıdı. Diğer bir deyişle, artık bir aramanın parçası olarak şu türleri kullanabilirsiniz:
countryadministrative_area_level_1administrative_area_level_2postal_codelocality
Dinamik yer verileri
Places API (Yeni) bir elektrikli araç şarj istasyonunun müsaitlik durumu veya bir benzin istasyonunun son yakıt fiyatları gibi dinamik yanıt verilerini destekler. Dinamik kullanıcı deneyimleri oluşturmak için bu yanıt alanlarını kullanın.
Hangi API'yi seçmelisiniz?
Uygulama geliştirmeye başlayabilmeniz için önce API'nizi seçmeniz gerekir:
Places API'yi kullanmaya yeni başlayan yeni bir müşteriyseniz, yeni API'lerle başlayın.
Yeni bir müşteriyseniz ve henüz otomatik Yer Tamamlama veya Sorgu Otomatik Tamamlama gibi mevcut bir API'nin yerine geçecek bir API yoksa yeni ve mevcut API'lerin bir kombinasyonunu kullanabilirsiniz.
Mevcut bir müşteriyseniz mevcut API'leri kullanmaya devam edebilirsiniz. Bununla birlikte, Places API'nin (Yeni) performans iyileştirmelerinden ve özellik geliştirmelerinden yararlanmak için yeni API'lere geçebilirsiniz.
Taşıma hakkında daha fazla bilgi edinmek için Taşımaya genel bakış başlıklı makaleyi inceleyin.