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 listesi
Aşağıdaki tabloda her iki API grubu da listelenmiştir. Mevcut bir müşteriyseniz şu anda 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.
Rehber 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ındakiler 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 maskelemeyi kullanmak, gereksiz veri istemediğinizden emin olmak için iyi bir tasarım uygulamasıdır. Bu, gereksiz işlem süresinden ve faturalandırma ücretlerinden kaçınmanıza yardımcı olur.
Bir yer için tutarlı yanıt verileri
Mevcut API'lerde Yer Ayrıntıları, Yakındakiler Arama ve Metin Arama API'leri bir yer için farklı yanıt verileri döndürüyordu. Places API (Yeni), yanıtı standartlaştırır. Böylece bu API'lerin tümü bir yer için aynı verileri döndürür.
Genişletilmiş yer türleri
API yanıtı artık bir yerin birincil türünü içerebilir. Her yer, Tablo A'da listelendiği gibi yerin birincil türü olarak belirtilen tek bir tür değerine sahip 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'nin 2. Tablosu'ndan Places API (Yeni) için A Tablosu'na taşıdı. Bu sayede artık aşağıdaki türleri bir aramanın parçası olarak kullanabilirsiniz:
countryadministrative_area_level_1administrative_area_level_2postal_codelocality
Dinamik yer verileri
Places API (Yeni), elektrikli araç şarj istasyonunun müsaitlik durumu veya bir benzin istasyonunun 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:
Places API'yi 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şımaya genel bakış başlıklı makaleyi inceleyin.