Places API iki API sürümünü destekler: Mevcut API'ler Places API, API'lerin yeni nesil sürümü ise Places API (Yeni)'dir.
Places API'nin (Yeni) kullanıma sunulmasıyla birlikte ilk göreviniz, kullanılacak API grubuna karar vermektir. Bu durum, yeni bir müşteriyseniz veya API'leri zaten kullanıyorsanız geçerlidir. İki API arasındaki temel farkları anlamak için bu kılavuzu kullanın.
API'lerin listesi
Aşağıdaki tabloda her iki API grubu da listelenmiştir. Mevcut bir müşteriyseniz kullandığınız API'nin yerini alacak yeni API'yi belirlemek için bu tabloyu kullanın.
| Places API | Places API (Yeni) | Not |
|---|---|---|
| Yer Bulma | Metin Arama (Yeni) | Yer Bul'un yeni bir sürümü yoktur. Bunun yerine Metin Arama (Yeni) özelliği kullanıma sunuldu. |
| Yakında Arama | Yakında Arama (Yeni) | Mevcut API'yi kullanan ve metin sorgusu içeren tüm istekler, metin girişini desteklemediği için Yakınımda Arama (Yeni) yerine Metin Arama (Yeni)'yi 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) | |
| Otomatik Sorgu Tamamlama | Otomatik tamamlama (Yeni) | Otomatik Tamamlama'ya eklenen özellikler (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. Uygulamanız için kullanılan API anahtarıyla ilişkili projede yalnızca Places API etkinse uygulamanız yeni API'lere erişemez.
Places API (Yeni): iOS için Yerler SDK'sına eklenen temel özellikler (Yeni) başlıklı makalede açıklanan tüm yeni API'leri ve özellikleri etkinleştirir. Uygulamanız mevcut API'lere erişemez.
İkisi de: Hem iOS için Yerler SDK'sı (Yeni) hem de iOS için Yerler SDK'sı'nın tüm özelliklerini ve API'lerini etkinleştirir.
Places API hizmetini seçme hakkında daha fazla bilgi için Google Cloud projenizi ayarlama başlıklı makaleyi inceleyin.
Yeni API'lere geçiş
Mevcut bir API kullanıyorsanız ve yeni API'ye geçmek istiyorsanız her API için aşağıdaki taşıma kılavuzlarına bakın:
- Yakında Arama'ya geçiş (Yeni)
- Metin aramaya taşıma (Yeni)
- Yer Ayrıntıları'na taşıma (Yeni)
- Yer fotoğrafına taşıma (Yeni)
- Otomatik Tamamlama'ya taşıma (Yeni)
Places API'ye eklenen temel özellikler (Yeni)
Bu bölümde, Places API'ye (Yeni) eklenen önemli özellikler ele alınmaktadır.
Google Cloud standart platformunda uygulanır.
Places API (Yeni), Google Cloud'daki hizmet altyapısında uygulanır. Bu uygulama, OAuth gibi gelişmiş güvenlik seçeneklerine sahip daha güvenli ve güvenilir bir platform sunar. Bu standart API tasarımı, API'ler arasında tutarlılık düzeyi sağlayarak Places API (Yeni) ile geliştirme verimliliğini artırır.
Artırılmış performans
Places API (Yeni), daha iyi performans sunar. Bu nedenle, mevcut Places API'yi kullanan uygulamaları değiştirmek faydalı olabilir.
Basitleştirilmiş fiyatlandırma
Yalnızca kullandığınız veriler için ödeme yapmanız amacıyla, fiyatlandırma Places API (Yeni) ile basitleştirilmiştir. 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 alan 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 maskeleme, gereksiz veri istemediğinizden emin olmak için iyi bir tasarım uygulamasıdır. Bu sayede gereksiz işlem süresi ve faturalandırma ücretlerinden kaçınabilirsiniz.
Bir yer için tutarlı yanıt verileri
Mevcut API'lerde Yer Ayrıntıları, Yakındaki Arama ve Metin Arama API'leri bir yer için farklı yanıt verileri döndürüyordu. Yerler API'si (Yeni), yanıtı standartlaştırarak bu API'lerin hepsinin 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 değeri olabilir.
Ayrıca yeni API, aşağıdaki tabloda gösterilen yer türlerini ekler. Bu yeni türleri ve mevcut türleri, Yakındakiler Arama (Yeni) ve Metin Arama (Yeni) ile yapılan bir aramada kullanabilirsiniz. Yeni türlerin tümü Tablo A'ya dahildir.
| 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 evi | 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 | terzi |
| 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 | helikopter pisti | oyun alanı | 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 |
Bu yeni türlerin yanı sıra Places API (Yeni), aşağıdaki türleri Places API için Tablo 2'den Places API (Yeni) için Tablo A'ya taşıdı. Yani artık arama kapsamında aşağıdaki türleri kullanabilirsiniz:
countryadministrative_area_level_1administrative_area_level_2postal_codelocality
Dinamik yer verileri
Places API (Yeni), elektrikli araç şarj istasyonunun müsaitliği veya bir benzin istasyonundaki en 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çiyorsunuz?
Uygulama geliştirmeye başlamadan önce API'nizi seçmeniz gerekir:
Yerler API'sini kullanmaya yeni başlayan bir yeni müşteriyseniz yeni API'leri kullanmaya başlayın.
Yeni bir müşteriyseniz ve henüz mevcut bir API'nin yerine geçecek bir API yoksa (ör. Yer Otomatik Tamamlama veya Sorgu Otomatik Tamamlama) yeni ve mevcut API'leri birlikte kullanabilirsiniz.
Mevcut bir müşteriyseniz mevcut API'leri kullanmaya devam edebilirsiniz. Ancak 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 için Taşıma işlemine genel bakış başlıklı makaleyi inceleyin.