Places API, iki API sürümünü destekler: Places API, mevcut API'ları ve Places API'sini (Yeni) sıradaki oluşturmamıza yardımcı oluyor.
Places API'nin (Yeni) kullanıma sunulmasıyla birlikte ilk göreviniz, hangi işletmenin API seti var. Bu durum, yeni veya mevcut bir müşteriyseniz kullandığının bir göstergesi. Temel bilgileri anlamak için bu kılavuzu kullanın iki API arasındaki farklar.
API listesi
Aşağıdaki tabloda her iki API grubu da listelenmiştir. Zaten müşteriyseniz kullandığınız API'nin yerini alacak yeni API'yi belirlemek için bu tabloyu kullanın. belirleyebilirsiniz.
| 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) | Metin sorgusu içeren mevcut API'yi kullanan tüm istekler Metin Arama (Yeni) çünkü Yakındaki Arama (Yeni) metin girişini desteklemiyor. |
| 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) |
Etkinleştirdiğiniz Places API hizmetinin sürümü üzerindeki erişim düzeyi, uygulamanızın kullandığı API'leri kontrol eder:
Places API: Mevcut API'leri etkinleştirir. Yalnızca Rehber API'si, şununla ilişkilendirilmiş proje için etkinleştirildi: API anahtarını kullanırsanız uygulamanız yeni API'lere erişemez.
Places API (Yeni): Tüm yeni API'leri ve iOS için Yerler SDK'sı (Yeni). Uygulamanız şunları yapmaz: mevcut API'lere erişimi olması gerekir.
Her ikisi: Her ikisi için de tüm özellikleri ve API'leri etkinleştirir iOS için Yerler SDK'sı (Yeni) ve iOS için Yerler SDK'sı.
Places API hizmetini seçme hakkında daha fazla bilgi için Google Cloud projenizi oluşturma başlıklı makaleyi inceleyin.
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 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) hizmet altyapısı Google Cloud'da deneyin. Bu uygulama, uygulamanın yürütülmesi sırasında gelişmiş güvenlik seçenekleriyle sunulan OAuth. Bu standart API Tasarım, verimliliği artıran API'ler arasında tutarlılık düzeyi sunar. (Yeni) inceleyebilirsiniz.
Artırılmış performans
Places API (Yeni) daha iyi performans sağlar, Bu da mevcut Places API'sini kullanan uygulamaların değiştirilmesini kolaylaştırır.
Basitleştirilmiş fiyatlandırma
Fiyatlandırma, Places API (Yeni) ile kolaylaştırılmıştır. Böylece, yalnızca yalnızca kullandığınız veri için ödeme yaparsınız. Basitleştirilmiş fiyatlandırma, alan maskesi gibi).
Yer Ayrıntılarıyla (Yeni), Yakındaki Arama (Yeni) ve Metin Arama (Yeni) aracını kullanarak cevapta döndürülecek alanların listesini içerir. Bu durumda yalnızca veriler için faturalandırılırsınız istendi. Alan maskelemeyi kullanmak iyi bir tasarım uygulamasıdır: Gereksiz veri istemeyiz, bu da gereksiz işleme süresini önler ve faturalandırma ücretleri dahil edilir.
Bir yer için tutarlı yanıt verileri
Mevcut API'lerle Yer Ayrıntıları, Yakındaki Arama ve Metin Arama API'ler bir yer için farklı yanıt verileri döndürdü. Places API (Yeni) bu API'lerin tümü bir yer için aynı verileri döndürecek şekilde yanıtı standartlaştırır.
Genişletilmiş yer türleri
API yanıtı artık bir yerin birincil türünü içerebilir. Her yerin sunabileceği aşağıda belirtildiği gibi, yerin birincil türü olarak belirtilen tek bir tür değeri: Tablo A.
Ayrıca yeni API, aşağıdaki tabloda gösterilen yer türlerini de ekler. Şunları yapabilirsiniz: içeren bir aramada bu yeni türleri ve mevcut Yakındaki Arama (Yeni) ve Metin Arama (Yeni). Yeni türlerin hepsi Tablo A.
| 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 | 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ürlerle birlikte Places API (Yeni) aşağıdaki türleri de taşıdı Places API için Tablo 2'den Places API için A Tablosuna (Yeni) kadar bir değer sunar. Yani artık bu türleri bir eğitim programının ara:
countryadministrative_area_level_1administrative_area_level_2postal_codelocality
Dinamik yer verileri
Places API (Yeni) müsaitlik durumu gibi dinamik yanıt verilerini destekler bir elektrikli araç şarj istasyonu veya bir benzin istasyonunun güncel yakıt fiyatları. Tekliflerinizi otomatikleştirmek ve optimize etmek için bu yanıt alanlarını kullanarak dinamik kullanıcı deneyimleri oluşturun.
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 yeni bir müşteriyseniz Otomatik Yer Tamamlama veya Sorgu gibi mevcut bir API Otomatik tamamlama'yı etkinleştirdiğinizde yeni ve mevcut API'leri bir arada kullanabilirsiniz.
Mevcut bir müşteriyseniz, API'ler. Ancak, performans iyileştirmelerinden ve yeni kullanıma sunulan Rehber API'sine (Yeni) geçerek yeni API'ler var.
Taşıma hakkında daha fazla bilgi edinmek için Taşıma işlemini gerçekleştirme genel bakış bölümüne bakın.