Yer Ayrıntıları (Yeni)

Platform seçin: Android iOS JavaScript Web Hizmeti

Yer kimliğiniz olduktan sonra Yer Ayrıntıları (Yeni) isteği göndererek belirli bir kuruluş veya önemli yer hakkında daha fazla ayrıntı isteyebilirsiniz. Yer Ayrıntıları (Yeni) isteği, belirtilen yerle ilgili daha kapsamlı bilgiler (ör. tam adres, telefon numarası, kullanıcı puanı ve yorumlar) döndürür.

Yer kimliği edinmenin birçok yolu vardır. Şunları kullanabilirsiniz:

API Gezgini, API'ye ve API seçeneklerine aşina olabilmeniz için canlı istek göndermenize olanak tanır:

Deneyin.

Yer Ayrıntıları (Yeni) istekleri

Yer Ayrıntıları isteği, aşağıdaki biçimde bir HTTP GET isteğidir:

https://places.googleapis.com/v1/places/PLACE_ID

Tüm parametreleri URL parametreleri olarak veya GET isteği kapsamında üst bilgilerde iletin. Örneğin:

https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw?fields=id,displayName&key=API_KEY

Alternatif olarak bir cURL komutunda:

curl -X GET -H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: id,displayName" \
https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw

Yer Ayrıntıları (Yeni) yanıtları

Yer Ayrıntıları (Yeni), yanıt olarak bir JSON nesnesi döndürür. Yanıtta:

  • Yanıt, bir Place nesnesi ile temsil edilir. Place nesnesi, yerle ilgili ayrıntılı bilgileri içerir.
  • İstekte iletilen FieldMask, Place nesnesinde döndürülen alanların listesini belirtir.

JSON nesnesinin tamamı şu şekildedir:

{
  "name": "places/ChIJkR8FdQNB0VQRm64T_lv1g1g",
  "id": "ChIJkR8FdQNB0VQRm64T_lv1g1g",
  "displayName": {
    "text": "Trinidad"
  }
  ...
}

Gerekli parametreler

  • FieldMask

    Yanıt alanı maskesi oluşturarak yanıtta döndürülecek alanların listesini belirtin. Yanıt alan maskesini, URL parametresi $fields veya fields'yi ya da HTTP üst bilgisi X-Goog-FieldMask'yi kullanarak yönteme iletin. Yanıtta varsayılan bir döndürülen alan listesi yok. Alan maskesini atlarsanız yöntem bir hata döndürür.

    Alan maskeleme, gereksiz veri istememenizi sağlayan iyi bir tasarım uygulamasıdır. Bu uygulama, gereksiz işlem süresinden ve faturalandırma ücretlerinden kaçınmanıza yardımcı olur.

    Döndürülecek yer veri türlerinin virgülle ayrılmış bir listesini belirtin. Örneğin, bir yerin görünen adını ve adresini almak için

    X-Goog-FieldMask: displayName,formattedAddress

    Tüm alanları almak için * değerini kullanın.

    X-Goog-FieldMask: *

    Aşağıdaki alanlardan birini veya daha fazlasını belirtin:

    • Aşağıdaki alanlar Yer Ayrıntıları (Yalnızca Kimlikler) SKU'sunu tetikler:

      attributions, id, name*, photos

      * name alanı, places/PLACE_ID biçiminde kaynak adını içerir. Yerin metin adına erişmek için displayName kullanın.

    • Aşağıdaki alanlar Yer Ayrıntıları (Yalnızca Konum) SKU'sunu tetikler:

      addressComponents, adrFormatAddress, formattedAddress, location, plusCode, shortFormattedAddress, types, viewport

    • Aşağıdaki alanlar Yer Ayrıntıları (Temel) SKU'sunu tetikler:

      accessibilityOptions, businessStatus, containingPlaces, displayName, googleMapsLinks*, googleMapsUri, iconBackgroundColor, iconMaskBaseUri, primaryType, primaryTypeDisplayName, pureServiceAreaBusiness, subDestinations, utcOffsetMinutes

      * googleMapsLinks alanı GA öncesi önizleme aşamasındadır ve önizleme sırasında kullanım için ücret alınmaz. Yani faturalandırma 0 ABD dolarıdır.

    • Aşağıdaki alanlar Yer Ayrıntıları (Gelişmiş) SKU'sunu tetikler:

      currentOpeningHours, currentSecondaryOpeningHours, internationalPhoneNumber, nationalPhoneNumber, priceLevel, priceRange, rating, regularOpeningHours, regularSecondaryOpeningHours, userRatingCount, websiteUri

    • Aşağıdaki alanlar Yer Ayrıntıları (Tercih Edilen) SKU'sunu tetikler:

      allowsDogscurbsidePickupdeliverydineIneditorialSummaryevChargeOptionsfuelOptionsgoodForChildrengoodForGroupsgoodForWatchingSportsliveMusicmenuForChildrenparkingOptionspaymentOptionsoutdoorSeatingreservablerestroomreviewsroutingSummariesservesBeerservesBreakfastservesBrunchservesCocktailsservesCoffeeservesDessertservesDinnerservesLunchservesVegetarianFoodservesWinetakeout

  • placeId

    Metin Arama (Yeni) veya Yakındakiler Arama (Yeni)'dan döndürülen, bir yeri benzersiz şekilde tanımlayan metin tanımlayıcı. Yer kimlikleri hakkında daha fazla bilgi için yer kimliklerine genel bakış başlıklı makaleyi inceleyin.

    places/PLACE_ID dizesi, yer kaynak adı olarak da adlandırılır. Yer Ayrıntıları (Yeni), Yakında Arama (Yeni) ve Metin Arama (Yeni) isteklerinden gelen yanıtta bu dize, yanıtın name alanında yer alır. Bağımsız yer kimliği, yanıtın id alanında yer alır.

İsteğe bağlı parametreler

  • languageCode

    Sonuçların döndürüleceği dil.

    • Desteklenen dillerin listesini inceleyin. Google, desteklenen dilleri sıklıkla güncellediğinden bu liste tam kapsamlı olmayabilir.
    • languageCode sağlanmazsa API varsayılan olarak en olur. Geçersiz bir dil kodu belirtirseniz API INVALID_ARGUMENT hatası döndürür.
    • API, hem kullanıcı hem de bölge sakinlerinin okuyabileceği bir açık adres sağlamak için elinden geleni yapar. Bu hedefe ulaşmak için yerel dildeki açık adresleri, gerekirse kullanıcı tarafından okunabilecek bir alfabeye dönüştürülerek tercih edilen dile uyarlar. Diğer tüm adresler ise tercih edilen dilde döndürülür. Adres bileşenlerinin tümü, ilk bileşenden seçilen aynı dilde döndürülür.
    • Tercih edilen dilde bulunmayan bir ad varsa API en yakın eşlemeyi kullanır.
    • Tercih edilen dil, API'nin döndürmeyi seçtiği sonuç grubu ve bu sonuçların döndürülme sırası üzerinde küçük bir etkiye sahiptir. Coğrafi kodlayıcı, kısaltmaları dile göre farklı şekilde yorumlar. Örneğin, sokak türlerinin kısaltmaları veya bir dilde geçerli olup başka bir dilde geçerli olmayan eş anlamlılar.

  • regionCode

    Yanıtı biçimlendirmek için kullanılan bölge kodu. İki karakterli CLDR kodu değeri olarak belirtilir. Varsayılan bir değer yok.

    Yanıttaki formattedAddress alanının ülke adı regionCode ile eşleşirse ülke kodu formattedAddress'ten çıkarılır. Bu parametrenin, ülke adını her zaman içeren adrFormatAddress veya hiçbir zaman içermeyen shortFormattedAddress üzerinde etkisi yoktur.

    CLDR kodlarının çoğu, bazı önemli istisnalar dışında ISO 3166-1 kodlarıyla aynıdır. Örneğin, Birleşik Krallık'ın ccTLD'si "uk" (.co.uk) iken ISO 3166-1 kodu "gb"dir (teknik olarak "Büyük Britanya ve Kuzey İrlanda Birleşik Krallığı" tüzel kişiliği için). Parametre, geçerli yasaya göre sonuçları etkileyebilir.

  • sessionToken

    Oturum jetonları, Otomatik Tamamlama (Yeni) çağrılarını "oturumlar" olarak izleyen, kullanıcı tarafından oluşturulan dizelerdir. Otomatik Tamamlama (Yeni), faturalandırma amacıyla kullanıcı otomatik tamamlama aramasının sorgu ve yer seçimi aşamalarını ayrı bir oturumda gruplandırmak için oturum jetonlarını kullanır. Oturum jetonları, Otomatik Tamamlama (Yeni) çağrılarını takip eden Yer Ayrıntıları (Yeni) çağrılarına aktarılır. Daha fazla bilgi için Oturum jetonları bölümüne bakın.

Yer ayrıntıları örneği

Aşağıdaki örnekte, placeId tarafından bir yerin ayrıntıları istenir:

curl -X GET -H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: id,displayName" \
https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw

X-Goog-FieldMask başlığının, yanıtın şu veri alanlarını içerdiğini belirttiğini unutmayın: id,displayName. Yanıt şu şekildedir:

{
  "id": "ChIJj61dQgK6j4AR4GeTYWZsKWw",
  "displayName": {
    "text": "Googleplex",
    "languageCode": "en"
  }
}

Ek bilgiler döndürmek için alan maskesine daha fazla veri türü ekleyin. Örneğin, formattedAddress,plusCode ekleyerek adresi ve Artı Kodu yanıta ekleyin:

curl -X GET -H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: id,displayName,formattedAddress,plusCode" \
https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw

Yanıt şu şekilde görünür:

{
  "id": "ChIJj61dQgK6j4AR4GeTYWZsKWw",
  "formattedAddress": "1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA",
  "plusCode": {
    "globalCode": "849VCWC7+RW",
    "compoundCode": "CWC7+RW Mountain View, CA, USA"
  },
  "displayName": {
    "text": "Googleplex",
    "languageCode": "en"
  }
}

Deneyin!

API Gezgini, API'ye ve API seçeneklerine aşina olabilmeniz için örnek istekler göndermenize olanak tanır.

İstekte bulunmak için:

  1. Sayfanın sağ tarafındaki API simgesini API Gezgini'ni genişletin. seçin.
  2. İsteğe bağlı olarak name parametresini şu şekilde ayarlayın: 
    places/PLACE_ID
  3. İsteğe bağlı olarak Standart parametreleri göster'i genişletin ve fields parametresini alan maskesine ayarlayın.
  4. Yürüt düğmesini seçin. Pop-up'ta, isteği göndermek için kullanmak istediğiniz hesabı seçin.

  5. API Gezgini panelinde, API Gezgini penceresini genişletmek için genişlet simgesini API Gezgini'ni genişletin. seçin.