Giriş
Yer Ayrıntıları (Yeni), Yakındakiler Arama (Yeni) ve Metin Arama (Yeni) API'lerinin yanıt biçimi, eski API'lerin biçiminden farklıdır. Temel fark, Yer nesnesi yanıtında yapılan değişiklikler bölümünde açıklandığı gibi, her yöntemin döndürdüğü Place nesnesinin biçimindedir.
Ayrıca, yanıt nesnesinin üst düzey alanları da her API için değişti. Şu konulara göz atın:
- Metin arama yanıtı değişiklikleri
- Yakındakiler araması yanıtında yapılan değişiklikler
- Yer Ayrıntıları yanıtında yapılan değişiklikler
Yanıt yer nesnesinde yapılan değişiklikler
Bu tabloda, Yer Ayrıntıları (Yeni), Yakındaki Arama (Yeni) ve Metin Arama (Yeni) isteklerinin yanıtındaki yeni
Place nesnesinde eski
Place nesnesine kıyasla yapılan değişiklikler gösterilmektedir.
Yeni yanıt nesnesi, alan adları için büyük/küçük harf kullanımını kullanır, yeni alanlar içerir ve eski alanlardan bazılarını yeniden adlandırır.
| Alan | Places API (eski) nesnesi | Places API (Yeni) nesnesi | Notlar |
|---|---|---|---|
| Adres bileşeni | address_components |
addressComponents |
|
| Yer mikro biçimi adresi | adr_address |
adrFormatAddress |
|
| İşletme durumu | business_status |
businessStatus |
|
| Önümüzdeki haftanın çalışma saatleri | current_opening_hours |
currentOpeningHours |
|
| İçerik özeti | editorial_summary |
editorialSummary |
|
| Biçimlendirilmiş adres | formatted_address |
formattedAddress |
|
| Ulusal telefon numarası | formatted_phone_number |
nationalPhoneNumber |
|
| Konum | geometry.location |
location |
|
| Görüntü alanı | geometry.viewport |
viewport |
|
| Yer ilişkilendirmeleri | html_attributions |
attributions |
Eski API'lerdeki yanıtın üst düzey alanı |
| Simge URL'si | icon |
Kaldırıldı. iconMaskBaseUri ve iconBackgroundColor özelliğini kullanın. Daha fazla bilgi için Simge yerleştirme bölümüne bakın. |
|
| Simge arka plan rengi | icon_background_color |
iconBackgroundColor |
|
| Simge maskesi URL'si | icon_mask_base_uri |
iconMaskBaseUri |
|
| Uluslararası telefon numarası | international_phone_number |
internationalPhoneNumber |
|
| Metin yer adı | name |
displayName |
Metin yer adına artık displayName.text ve language olarak erişilebilir.displayName.languageCode |
| Çalışma saatleri | opening_hours |
regularOpeningHours |
|
| Fotoğraflar | photos |
photos |
Yeni Place nesnesinde photos biçimi değişti. Daha fazla bilgi için Fotoğraf referanslarına geçme başlıklı makaleyi inceleyin. |
| Yer kimliği | place_id |
id |
|
| Plus code | plus_code |
plusCode |
|
| Fiyat düzeyi | price_level |
priceLevel |
|
| Derecelendirme | rating |
rating |
|
| Yorumlar | reviews |
reviews |
|
| İstisnalar ve diğer tüm verilerle birlikte, önümüzdeki hafta için bugünden itibaren geçerli ikincil çalışma saatleri | secondary_opening_hours |
currentSecondaryOpeningHours |
|
| Yer türleri | types |
types |
|
| Yerin Google Haritalar URL'si | url |
googleMapsUri |
|
| Kullanıcı puanı sayısı | user_ratings_total |
userRatingCount |
|
| UTC farkı | utc_offset |
utcOffsetMinutes |
|
| Sokak adı ve ilçe dahil olmak üzere adresin kısa formu | vicinity |
shortFormattedAddress |
|
| Yerin web sitesi | website |
websiteUri |
|
| Tekerlekli sandalyeye uygunluk bilgileri | wheelchair_accessible_entrance |
accessibilityOptions |
wheelchair_accessible_entrance şu anda
accessibilityOptions.wheelchairAccessibleEntrance |
| Yer özellikleri | takeout, delivery, dine_in, curbside_pickup, reservable,
serves_breakfast, serves_lunch, serves_dinner, serves_beer, serves_wine,
serves_brunch, serves_vegetarian_food |
takeout, delivery, dineIn, curbsidePickup, reservable,
servesBreakfast, servesLunch, servesDinner, servesBeer, servesWine,
servesBrunch, servesVegetarianFood |
|
| Kaynak adı | places/PLACE_ID formundaki name alanı |
Eski API'de name alanı, yer adını metin dizesi olarak içeriyordu. Yeni API'de bu bilgiler displayName içindedir. |
|
| Yerin birincil türü | primaryTypeName |
Yeni | |
| Birincil türü metin dizesi olarak yerleştirme | primaryTypeDisplayName |
Yeni | |
| İstisnalar ve diğer tüm verilerle birlikte normal haftalık ikincil çalışma saatleri | regularSecondaryOpeningHours |
Yeni | |
| Yerin kabul ettiği ödeme seçenekleri | paymentOptions |
Yeni | |
| Yer park seçenekleri | parkingOptions |
Yeni | |
| Yerle ilgili alt hedeflerin listesi | subDestinations |
Yeni | |
| Benzin istasyonundaki yakıt seçenekleri hakkında en güncel bilgiler | fuelOptions |
Yeni | |
| Bir yerle ilgili elektrikli araç şarjı bilgileri | evChargeOptions |
Yeni | |
| Yer özellikleri | outdoorSeating, liveMusic, menuForChildren, servesCocktails,
servesDessert, servesCoffee, goodForChildren, allowsDogs, restroom,
goodForGroups, goodForWatchingSports |
Yeni |
Metin arama yanıtı değişiklikleri
Aşağıdaki tabloda, Metin Arama (eski) için yanıt nesnesinin ve Metin Arama (yeni) için yanıt nesnesinin üst düzey alanlarında yapılan değişiklikler gösterilmektedir. Yeni API'de, yanıttaki tek üst düzey alan places dizisidir.
| Alan | Metin Arama (Eski) | Metin Arama (Yeni) | Notlar |
|---|---|---|---|
| Yer ilişkilendirmeleri | html_attributions |
Her yer için place.attributions olarak yeni Place nesnesine taşındı |
|
| Yer dizisi | Eski Place nesnesinin results dizisi |
places yeni Place nesnesi dizisi |
|
| İsteğin durumu | status |
Standart HTTP yanıtına (HTTP yanıt kodu ve mesajı) taşındı | |
| Hata mesajları | error_message |
Standart HTTP yanıtına (HTTP yanıt kodu ve mesajı) taşındı | |
| Tüm bilgi mesajları | info_messages |
Kaldırıldı | |
| Sayfa jetonu | next_page_token |
Kaldırıldı |
Yakında Arama yanıtı değişiklikleri
Aşağıdaki tabloda, Yakındaki Arama (eski) için yanıt nesnesinin ve Yakındaki Arama (yeni) için yanıt nesnesinin üst düzey alanlarında yapılan değişiklikler gösterilmektedir. Yeni API'de, yanıttaki tek üst düzey alan places dizisidir.
| Alan | Yakında Arama (eski) | Yakında Arama (Yeni) | Notlar |
|---|---|---|---|
| Yer ilişkilendirmeleri | html_attributions |
Her bir yer için place.attributions olarak yeni Place nesnesine taşındı |
|
| Yer dizisi | Eski Place nesnesinin results dizisi |
places yeni Place nesnesi dizisi |
|
| İsteğin durumu | status |
Standart HTTP yanıtına (HTTP yanıt kodu ve mesajı) taşındı | |
| Hata mesajları | error_message |
Standart HTTP yanıtına (HTTP yanıt kodu ve mesajı) taşındı | |
| Tüm bilgi mesajları | info_messages |
Kaldırıldı | |
| Sayfa jetonu | next_page_token |
Kaldırıldı |
Yer Ayrıntıları (Yeni) yanıtında yapılan değişiklikler
Aşağıdaki tabloda, Yer Ayrıntıları (eski) için yanıt nesnesinin ve Yer Ayrıntıları (yeni) için yanıt nesnesinin üst düzey alanlarında yapılan değişiklikler gösterilmektedir. Yeni API'de, yanıttaki tek üst düzey alan places dizisidir.
| Alan | Yer Ayrıntıları (eski) | Yer Ayrıntıları (Yeni) | Notlar |
|---|---|---|---|
| Yer ilişkilendirmeleri | html_attributions |
Yeni Yer nesnesine attributions olarak taşındı |
|
| Yer Ayrıntıları (Yeni) | Eski Place nesnesini içeren result |
Yeni Yer nesnesi | |
| İsteğin durumu | status |
Standart HTTP yanıtına (HTTP yanıt kodu ve mesajı) taşındı | |
| Tüm bilgi mesajları | info_messages |
Standart HTTP yanıtına (HTTP yanıt kodu ve mesajı) taşındı |