Posted:

Ever wanted to be someone else? No, we're not offering a Being John Malkovich service, but we are offering Maps API developers the default look-and-feel of maps.google.com, all with one simple function call.

Now, you can get the standard UI elements you'd see on Google Maps (including the newer style "3D" map and zoom controls), along with other standard behaviour such as keyboard and mouse handling, just by adding one line of code.

  // Create a map.
  var map = new GMap2(myMapDiv);
  // Give it the maps.google.com experience.
  map.setUIToDefault();

What's more, this function will ensure that if the UI of maps.google.com changes, these changes will also be reflected in your site without you having to update anything.

The function will automatically adjust what controls the map gets based on the size of the map. For maps larger than 300 x 400, the default controls are:

  • GLargeMapControl3D
  • GMapTypeControl
  • GScaleControl

For maps 300 x 400 or smaller, the default controls are:

  • GSmallZoomControl3D
  • GMenuMapTypeControl

Both will also enable scroll wheel zoom, double click zoom and add a GKeyboardHandler to the map.

You can also tweak the appearance to your liking. If you mostly want the standard behaviour, but, for example, don't want scroll wheel zoom enabled, you can get an instance of the default GMapUIOptions object, and adjust the fields to your liking.

  // Get the default GMapUIOptions.
  var uiOptions = map.getDefaultUI();
  // Disable scroll wheel zoom.
  uiOptions.zoom.scrollwheel = false;
  // Now set the map's UI with the tweaked options.
  map.setUI(uiOptions);

Along with this change, you can now also get direct access to the new 3D controls used on maps.google.com:

  • GLargeMapControl3D, and
  • GSmallZoomControl3D

A full reference of the functions, the GMapUIOptions class and all the defaults are available on the Google Maps API Reference. As always, head over to the forum if you have any questions.

Sorry that puppeteering of John M is not included, but at least now your site can easily look and act like Google Maps!

One more thing: if you want to meet the Maps API team and hear about other exciting things we're working on, come to Google I/O in May.

Posted:

March 5th, from 3-9pm, Google will be hosting a Google Geo APIs hackathon at our Manhattan offices, 111 8th Avenue at 15th street in Manhattan. Join us for some hacking around on Google Geo APIs. Work on our learning materials, or work on your own projects. There will presentations on new features in the APIs, and plenty of Geo Googlers around to help you with your technical questions. In particular, we will be helping people with the Google Maps API, the Google Earth API, and KML.

To register, click here. Space is limited, so you may want to register now.

Posted:


Since June 2008, thousands of passionate users have been mapping their heart out in mapmaker.google.com. The maps made are some of the finest ever seen in these 160+ countries. In a developer day we did in Bangalore, the top request from developers was if we can get these fresh maps in the API so that their users can benefit from the community's effort. We responded by launching the tiles from Map Maker as new map types in both the Google JavaScript Maps API (v2.146) and the Static Maps API as new map types. So if you have a Google maps mashup that is primarily used in one of these countries or you simply want to embed a fresh map in your blog post or web page, you can use these maps that are updated every day by the map maker community. Google is committed to providing the best maps possible to users everywhere and this is just one more step in our quest to make maps from mapmaker as useful to users as possible.

Here is how you can use these new features.

JS API syntax
Use G_MAPMAKER_NORMAL_MAP and G_MAPMAKER_HYBRID_MAP in lieu of the normal map and hybrid types to show mapmaker map tiles and hybrid tiles respectively. Remember that these serve maps only for the countries being edited in mapmaker, not all the countries available in maps.google.com. If you're making a mashup with a global audience, you may want to add logic to switch between the map types, or offer the option to the users.

Static Maps API syntax
users can access mapmaker tiles using 'maptype' values of "mapmaker-roadmap" or "mapmaker-hybrid" e.g. http://maps.google.com/staticmap?center=31.494445,74.334011&zoom=15&size=512x512&maptype=mapmaker-roadmap&key=MAPS_API_KEY&sensor=false

See the comparison of this URL vs the same URL without the "maptype=mapmaker-roadmap" for Lahore, Pakistan.

 


If you have data that you want to update yourself - whether you're a city GIS expert, a company's webmaster or just a local expert, you can edit map maker and the new data will show on your mashup within a day. For more information read the latest developments on our Lat Long blog, visit Map Maker, interact with the map maker community, or go to our help site. And, as always, please follow up with your suggestions and questions in the forum.

Posted:

Bom dia! добрый день!

(This post has been translated into Portuguese and Russian.)

During the past year, we've expanded translations of the Maps API documentation into more and more languages, making it easier for developers around the world to add Google Maps to their websites. Earlier in 2008, we provided Japanese and Simplified Chinese translations which we've recently updated.

Over the past few months, we've quietly released several more translations of the Maps API documentation, with Brazilian Portuguese and Russian being the latest to undergo a full translation. We previously added German and Spanish in September, 2008. Each of these translations can be found at the following URLs:

Additionally, you can change to translated documentation by selecting from the language selector in the top right portion of code.google.com's documentation pages. If a translation is available in that language, it will appear. (If no translation is available, default English will be shown.)

We've chosen these translations because they cover most of the non-English speaking readers of the Maps API documentation. We hope they will encourage a new group of developers to use the Google Maps APIs.

Note: although we will try to keep the translated documentation as up-to-date as possible, the English docs will often contain the latest information. (All developers should be sure to periodically check out the English Maps API Reference, which is updated every few weeks.)


***

Bom dia!

Ao longo do ano passado, nós expandimos os idiomas para os quais a documentação da Maps API é traduzida, facilitando que desenvolvedores ao redor do mundo adicionem Google Maps aos seus websites. No início de 2008, nós disponibilizamos traduções em japonês e chinês simplificado. Ambas as versões foram atualizadas recentemente.

Nos últimos meses, silenciosamente lançamos mais traduções completas da documentação da Maps API, com traduções para o alemão e o espanhol em setembro de 2008 e português (brasileiro) e russo, recentemente. Estas traduções podem ser encontradas nas seguintes URLs:

Você pode escolher entre as traduções utilizando o selecionador de idioma no canto superior direito da página de documentação do code.google.com. Se uma tradução estiver disponível naquele idioma, ela irá aparecer (caso contrário, a versão em inglês será exibida).

Nós escolhemos estes idiomas porque eles cobrem a maioria dos usuários da documentação da Maps API que não fala inglês. Esperamos que estas traduções encorajem um novo grupo de desenvolvedores a usar a Maps API da Google.

Nota: nós tentaremos manter as traduções tão atualizadas quanto possível. Porém, a versão em inglês irá, algumas vezes, conter informações mais recentes. (Desenvolvedores devem verificar periodicamente a documentação de referência da Maps API em inglês. Ela é atualizada há cada poucas semanas.)


***

Добрый день!

За последний год мы перевели документацию по API Карт на большое количество языков, и разработчикам по всему миру стало легче использовать Карты Google на своих сайтах. В начале 2008 года мы выпустили, а недавно обновили, переводы на японский и упрощённый китайский языки.

За несколько последних месяцев мы тихо и незаметно выпустили ещё несколько переводов документации по API карт. В сентябре появились немецкий и испанский переводы, а совсем недавно вышли переводы на бразильский, португальский и русский языки. Эти переводы можно найти здесь:

Вы можете переключиться на переведённую документацию, выбрав язык из выпадающего списка в правом верхнем углу страниц сайта code.google.com. Если перевод текста страницы для для выбранного языка существует, то он будет показан (если его нет, то будет показан текст на английском).

Мы выбрали именно эти языки, потому что большинство неанглоязычных читателей документации API Карт говорит именно на них. Надеемся, что переводы подтолкнут новых разработчиков к использованию API Карт Google.

Замечание: мы стараемся поддерживать переведённую документацию в актуальном состоянии, но часто англоязычная документация содержит наиболее свежую информацию. Всем разработчикам следует время от времени заглядывать в англоязычный справочник по API Карт, который обновляется раз в несколько недель.

Posted:

Back in December, Julie posted on the Google LatLong blog about a new directions gadget that webmasters can embed on their websites to make it super easy for people to find them. Check out that post for information on embedding and the diverse ways the gadget can be used (with coordinates, addresses, zip codes, and more).

The gadget uses the Google Maps API and jQuery, and does nifty things like display a "Did you mean..." when they've entered an ambiguous address and then animates the selected address flying into the form. For those of you developers who like the functionality but want the it more integrated more into your site, the good news is that you can easily copy, paste, and modify the code from the gadget XML spec.

Posted:

You've probably already read about this week's release of Google Earth 5.0 and its exciting new features, including Historical Imagery, Touring, Ocean, and Mars. As is usually the case for new features in Earth, we wanted to add representations for some of them to KML. In the past this was done by simply adding new elements to the KML specification. But that's no longer an option for us, since KML is no longer controlled by Google, having been released as an open standard by the Open Geospatial Consortium.

So what's an application provider to do? Fortunately, both Google and the OGC had the foresight to anticipate that innovation would continue to drive the standard forward, so OGC KML includes a standardized mechanism that enables any group to extend KML within their own XML namespace. Google Earth 5.0 uses this extension mechanism to add to KML in a standards-compliant way. We've also added some new documentation to guide you in understanding these new KML constructs:

  • First, something mentioned no where else, Google Earth now supports close to the full range of HTML and JavaScript in the description balloon! This is something that developers have been asking for, and we were able to change the HTML rendering engine to include it. For more details, check out the KML Reference for the description element.
  • We added a new Developer Guide article on Touring. The KML representation of touring is much more expressive than the simple record button in Google Earth -- KML tour authors have very precise control over the camera, the time slider, and even 3D object animation.
  • We added another Developer Guide article on altitudeMode, which explains among other things the new ability to place Features below the water surface.
  • We've updated the Time and Animation article to take into account touring and time machine. In particular, KML authors can now control the time slider, both inside and outside of a tour.
  • We updated our KML reference to include entries on all the of the new extension elements. The new elements are carefully called out in the documentation as being part of Google's KML extension namespace, to distinguish them from the core OGC KML elements.
  • And finally, we updated libkml to version 0.9. libkml is a powerful open source library for use with applications that want to parse, generate and operate on KML. The new version provides support for the extensions, as well as Update/Delete.

For those who are interested in precise XML validation of the new elements, please see Google's new KML 2.2 extensions XSD, which is the formal standards-compliant description of their syntax.

As always, you can find out more information or ask questions in the KML Developer Forum.